DataList.CreateItem(Int32, ListItemType) Method

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Creates a DataListItem object.

protected:
 virtual System::Web::UI::WebControls::DataListItem ^ CreateItem(int itemIndex, System::Web::UI::WebControls::ListItemType itemType);

protected virtual System.Web.UI.WebControls.DataListItem CreateItem (int itemIndex, System.Web.UI.WebControls.ListItemType itemType);

abstract member CreateItem : int * System.Web.UI.WebControls.ListItemType -> System.Web.UI.WebControls.DataListItem
override this.CreateItem : int * System.Web.UI.WebControls.ListItemType -> System.Web.UI.WebControls.DataListItem

Protected Overridable Function CreateItem (itemIndex As Integer, itemType As ListItemType) As DataListItem

Parameters

itemIndex: Int32

The specified location within the DataList to place the created item.

itemType: ListItemType

A ListItemType that represents the specified type of the item to create.

Returns

DataListItem

A new DataListItem created with the specified list-item type.

Remarks

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.

Applies to