Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

DataList.CreateItem-Methode

Aktualisiert: November 2007

Erstellt ein DataListItem-Objekt.

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

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

Parameter

itemIndex
Typ: System.Int32
Die angegebene Position in der DataList, an der das erstellte Element platziert werden soll.
itemType
Typ: System.Web.UI.WebControls.ListItemType
Ein ListItemType, der den angegebenen Typ des zu erstellenden Elements darstellt.

Rückgabewert

Typ: System.Web.UI.WebControls.DataListItem
Ein neues DataListItem, das mit dem angegebenen Listenelementtyp erstellt wurde.

Die CreateItem-Methode wird primär von Steuerelemententwicklern beim Erstellen einer benutzerdefinierten Implementierung des DataList-Steuerelements verwendet. Die CreateItem-Methode ist dem Aufruf des DataListItem-Konstruktors für ein DataListItem funktional gleichwertig. Die ItemIndex-Eigenschaft und die ItemType-Eigenschaft werden für das neue DataListItem mithilfe der angegebenen Werte initialisiert. Das Element wird jedoch nicht in die DataList eingefügt.

Die CreateControlHierarchy-Methode verwendet die CreateItem-Methode und die InitializeItem-Methode zum Erstellen von DataListItem-Steuerelementen, die die in der Datenliste enthaltenen Kopf- und Fußzeilen, Trennzeichen und datengebundenen Elemente darstellen. Sie können über die Items-Auflistung auf die datengebundenen Elemente für die Datenliste zugreifen. Sie können auf alle Elementtypen, einschließlich Kopfzeile, Fußzeile und Trennzeichenelementen, über die Controls-Auflistung zugreifen.

Hinweise zur Vererbung:

Durch Überschreiben dieser Methode können Sie Ihren eigenen abgeleiteten DataListItem-Typ erstellen oder zusätzliche Membereigenschaften festlegen, wenn ein DataListItem erstellt wird.

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

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Anzeigen: