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


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


itemValues is null.


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.