DataList.CreateItem メソッド

.NET Framework クラス ライブラリ リファレンス

DataList.CreateItem メソッド

DataListItem オブジェクトを作成します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim itemIndex As Integer
Dim itemType As ListItemType
Dim returnValue As DataListItem

returnValue = Me.CreateItem(itemIndex, itemType)

C#

protected virtual DataListItem CreateItem (
    int itemIndex,
    ListItemType itemType
)

C++

protected:
virtual DataListItem^ CreateItem (
    int itemIndex, 
    ListItemType itemType
)

J#

protected DataListItem CreateItem (
    int itemIndex, 
    ListItemType itemType
)

JScript

protected function CreateItem (
    itemIndex : int, 
    itemType : ListItemType
) : DataListItem

パラメータ

itemIndex

作成した項目を配置するための DataList 内の指定の場所。

itemType

作成する項目について指定した型を表す ListItemType。

戻り値
リスト項目の指定した型で作成された DataListItem。

解説

CreateItem メソッドは、DataList コントロールのカスタム実装を作成する場合に、主にコントロールの開発者によって使用されます。CreateItem メソッドは、機能的に DataListItem の DataListItem コンストラクタを呼び出すことと等価です。ItemIndex プロパティと ItemType プロパティは、指定された値を使用して新しい DataListItem 用に初期化されますが、項目は DataList に挿入されません。

CreateControlHierarchy メソッドは CreateItem メソッドと InitializeItem メソッドを使用し、ヘッダー、フッター、区切り記号、およびデータ リストに含まれているデータバインドされた項目を表す DataListItem コントロールを作成します。データ リストのデータバインドされた項目には、Items コレクションからアクセスできます。ヘッダー、フッター、および区切り記号の項目など、すべての項目の型には Controls コレクションからアクセスできます。

継承時の注意 独自の派生型である DataListItem を作成する、または DataListItem の作成時に追加のメンバ プロパティを設定するには、このメソッドをオーバーライドします。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DataList クラス
DataList メンバ
System.Web.UI.WebControls 名前空間
CreateControlHierarchy
InitializeItem
その他の技術情報
DataList Web サーバー コントロール