System.Web.UI.WebControls Namespace   FormView Class

.NET Framework version 2.0

Updates the current record in the data source.

[ VB ]
Overridable Public Sub UpdateItem ( _
   ByVal causesValidation As Boolean _
)

[ C# ]
public virtual void UpdateItem (
   bool causesValidation
);

[ C++ ]
public: virtual void UpdateItem (
   bool* causesValidation
);

[ JScript ]
public function UpdateItem (
   causesValidation : Boolean
);

causesValidation

true to perform page validation when the method is called; otherwise false.

When the FormView control is in edit mode, use the UpdateItem method to programmatically edit the current record in the data source. This method is commonly used when you need to edit the current record from outside of the FormView control, such as from a different control on the page.

NOTE: The FormView control must be in edit mode when this method is called; otherwise, an HttpException is thrown.

To specify whether page validation is performed before the update operation, use the causesValidation parameter. Calling this method also raises the ItemUpdated and ItemUpdating events.

The following example demonstrates how to use the UpdateItem method to programmatically edit the current record in a FormView control in the data source.

<%@ Page language = "C#" %>

<script runat = "server">
   void InsertButton_Click ( Object src, EventArgs e ) {
      try {
         EmployeeFormView.UpdateItem ( true );
         MessageLabel.Text = "";
      } catch ( HttpException ex ) {
         MessageLabel.Text = "The FormView control must be in edit mode to update a record.";
      }
   }

   void CancelButton_Click ( Object src, EventArgs e ) {
      // Return the FormView control to read-only mode.
      EmployeeFormView.ChangeMode ( FormViewMode.ReadOnly );
      MessageLabel.Text = "";
   }
</script>

<%@ Page language = "VB" %>

<script runat = "server">
   Sub InsertButton_Click ( ByVal src As Object, ByVal e As EventArgs )
      Try
         EmployeeFormView.UpdateItem ( True )
         MessageLabel.Text = ""
      Catch ex As HttpException
         MessageLabel.Text = "The FormView control must be in edit mode to update a record."
      End Try
   End Sub

   Sub CancelButton_Click ( ByVal src As Object, ByVal e As EventArgs )
      ' Return the FormView control to read-only mode.
      EmployeeFormView.ChangeMode ( FormViewMode.ReadOnly )
      MessageLabel.Text = ""
   End Sub
</script>

FormView Members   DeleteItem   InsertItem