This documentation is archived and is not being maintained.

ListView.ExtractItemValues Method

Retrieves the values of each field that is declared in the specified item, and stores them in the specified IOrderedDictionary object.

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

public virtual void ExtractItemValues(
	IOrderedDictionary itemValues,
	ListViewItem item,
	bool includePrimaryKey
)

Parameters

itemValues
Type: System.Collections.Specialized.IOrderedDictionary
A dictionary object that is used to store the field values.
item
Type: System.Web.UI.WebControls.ListViewItem
The ListViewItem object from which to retrieve the field values.
includePrimaryKey
Type: System.Boolean
true to include the primary key field or fields; otherwise, false.

ExceptionCondition
ArgumentNullException

itemValues is null.

InvalidOperationException

item is not a ListViewDataItem object.

The ExtractItemValues method is a helper method that is called by the ListView control to retrieve the values of each field that is declared in item. You can specify whether the extracted values include key fields by using the includePrimaryKey parameter.

.NET Framework

Supported in: 4, 3.5

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: