Export (0) Print
Expand All

DataList.CreateItem Method

Creates a DataListItem object.

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

protected virtual DataListItem CreateItem(
	int itemIndex,
	ListItemType itemType
)

Parameters

itemIndex
Type: System.Int32
The specified location within the DataList to place the created item.
itemType
Type: System.Web.UI.WebControls.ListItemType
A ListItemType that represents the specified type of the item to create.

Return Value

Type: System.Web.UI.WebControls.DataListItem
A new DataListItem created with the specified list-item type.

The CreateItem method is used primarily by control developers in creating a custom implementation of the DataList control. The CreateItem method is functionally equivalent to calling the DataListItem constructor for a DataListItem. The ItemIndex and ItemType properties are initialized for the new DataListItem using the specified values, but the item is not inserted into the DataList.

The CreateControlHierarchy method uses the CreateItem and InitializeItem methods to create DataListItem controls that represent the header, footer, separator, and data-bound items contained in the data list. You can access the data-bound items for the data list through the Items collection. You can access all item types, including the header, footer, and separator items, through the Controls collection.

Notes to Inheritors

Override this method to create your own derived DataListItem type, or to set additional member properties when a DataListItem is created.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, 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.

Community Additions

ADD
Show:
© 2014 Microsoft