This documentation is archived and is not being maintained.

ListView::UpdateItem Method

Updates the record at the specified index in the data source.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

public:
virtual void UpdateItem(
	int itemIndex, 
	bool causesValidation
)

Parameters

itemIndex
Type: System::Int32

The index of the item to update.

causesValidation
Type: System::Boolean

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

ExceptionCondition
InvalidOperationException

itemIndex is less than 0.

-or-

The DataSourceView object that is associated with the ListView control is nullptr.

Use the UpdateItem method to programmatically update the record at the specified index in the data source. You typically use this method when you want to update a record from outside the ListView control, such as from a different control on the page.

NoteNote:

This method can be called only for an item that contains a two-way data-bound input control. For more information about two-way binding expressions, see Binding to Databases.

To specify whether page validation is performed before the update operation, use the causesValidation parameter.

This method raises the ItemUpdated and ItemUpdating events.

The following example shows how to use the UpdateItem method to programmatically update a ListView item in the data source.

No code example is currently available or this language may not be supported.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5
Show: