DataList.CreateItem(Int32, ListItemType) 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

建立 DataListItem 物件。

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

參數

itemIndex

Int32

在 DataList 中要放置建立項目的指定位置。

itemType

ListItemType

ListItemType，表示要建立的指定項目型別。

傳回

DataListItem

使用指定清單項目型別建立的新 DataListItem。

備註

方法 CreateItem 主要是由控制項開發人員用來建立控制項的自訂實作 DataList 。 方法 CreateItem 的功能相當於呼叫 的 DataListItem DataListItem 建構函式。 和 ItemIndex ItemType 屬性是使用指定的值為新的 DataListItem 初始化，但專案不會插入 DataList 中。

方法 CreateControlHierarchy 會使用 CreateItem 和 InitializeItem 方法來建立 DataListItem 控制項，這些控制項代表資料清單中所包含的頁首、頁尾、分隔符號和資料繫結專案。 您可以透過 Items 集合存取資料清單的資料系結專案。 您可以透過 Controls 集合存取所有專案類型，包括頁首、頁尾和分隔符號專案。

給繼承者的注意事項

覆寫這個方法以建立您自己的衍生 DataListItem 型別，或在 建立 時 DataListItem 設定其他成員屬性。

另請參閱

• CreateControlHierarchy(Boolean)
• InitializeItem(DataListItem)