DataList.CreateItem-Methode
Erstellt ein DataListItem-Objekt.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Overridable Function CreateItem ( _
itemIndex As Integer, _
itemType As ListItemType _
) As DataListItem
'Usage
Dim itemIndex As Integer
Dim itemType As ListItemType
Dim returnValue As DataListItem
returnValue = Me.CreateItem(itemIndex, itemType)
protected virtual DataListItem CreateItem (
int itemIndex,
ListItemType itemType
)
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
Die angegebene Position in der DataList, an der das erstellte Element platziert werden soll.
- itemType
Ein ListItemType, der den angegebenen Typ des zu erstellenden Elements darstellt.
Rückgabewert
Ein neues DataListItem, das mit dem angegebenen Listenelementtyp erstellt wurde.
Hinweise
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 auf die datengebundenen Elemente für die Datenliste über die Items-Auflistung zugreifen. Sie können auf alle Elementtypen, einschließlich Kopfzeile, Fußzeile und Trennzeichenelementen, über die Controls-Auflistung zugreifen.
Hinweise für Erben Durch Überschreiben dieser Methode können Sie Ihren eigenen abgeleiteten DataListItem-Typ erstellen oder zusätzliche Membereigenschaften festlegen, wenn ein DataListItem erstellt wird.
Plattformen
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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
DataList-Klasse
DataList-Member
System.Web.UI.WebControls-Namespace
CreateControlHierarchy
InitializeItem