Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DataListItem-Klasse

.NET Framework 4.5

Andere Versionen

Stellt ein Element in einem DataList-Steuerelement dar.

Vererbungshierarchie

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.DataListItem

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

Syntax

C++

public class DataListItem : WebControl, 
	IDataItemContainer, INamingContainer

ASP.NET

<asp:DataListItem />

Der DataListItem-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	DataListItem	Initialisiert eine neue Instanz der DataListItem-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	AccessKey	Ruft die Zugriffstaste ab oder legt diesen fest. Auf diese Weise können Sie schnell in das Webserversteuerelement navigieren. (Von WebControl geerbt.)
	Adapter	Ruft den browserspezifischen Adapter für das Steuerelement ab. (Von Control geerbt.)
	AppRelativeTemplateSourceDirectory	Ruft das Symbol ab bzw. legt das anwendungsrelative virtuelle Verzeichnis des Page oder UserControl-Objekts fest, das dieses Steuerelement enthält. (Von Control geerbt.)
	Attributes	Ruft die Auflistung von beliebigen Attributen ab (nur für rendern) nicht die Eigenschaften des Steuerelements entsprechen. (Von WebControl geerbt.)
	BackColor	Ruft ab oder legt die Hintergrundfarbe des Webserversteuerelements festgelegt. (Von WebControl geerbt.)
	BindingContainer	Infrastruktur. Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Von Control geerbt.)
	BorderColor	Ruft ab oder legt die Rahmenfarbe des Websteuerelements fest. (Von WebControl geerbt.)
	BorderStyle	Ruft die Rahmenart des Webserversteuerelements festgelegt. (Von WebControl geerbt.)
	BorderWidth	Ruft die Rahmenbreite des Webserversteuerelements festgelegt. (Von WebControl geerbt.)
	ChildControlsCreated	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Von Control geerbt.)
	ClientID	Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Von Control geerbt.)
	ClientIDMode	Ruft den Algorithmus ab, der verwendet wird, um den Wert der ClientID-Eigenschaft zu generieren. (Von Control geerbt.)
	ClientIDSeparator	Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID-Eigenschaft verwendet wird. (Von Control geerbt.)
	Context	Ruft das HttpContext-Objekt ab, das dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Von Control geerbt.)
	Controls	Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt. (Von Control geerbt.)
	ControlStyle	Ruft das Format des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	ControlStyleCreated	Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	CssClass	Ruft die CSS-Klasse (Cascading Style Sheet) ab, die vom Webserversteuerelement auf dem Client gerenderte. (Von WebControl geerbt.)
	DataItem	Ruft ein Datenelement ab, das dem DataListItem-Objekt im DataList-Steuerelement zugeordnet ist, oder legt dieses fest.
	DataItemContainer	Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainerimplementiert. (Von Control geerbt.)
	DataKeysContainer	Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControlimplementiert. (Von Control geerbt.)
	DesignMode	Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Von Control geerbt.)
	Enabled	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Webserversteuerelement aktiviert ist. (Von WebControl geerbt.)
	EnableTheming	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob für dieses Steuerelement Designs gelten. (Von WebControl geerbt.)
	EnableViewState	Ruft einen Wert ab oder legt einen Wert, der angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand beibehält, aller untergeordneten Steuerelemente, die dem anfordernden Client, enthält es fest. (Von Control geerbt.)
	Events	Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Von Control geerbt.)
	Font	Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Von WebControl geerbt.)
	ForeColor	Ruft die Vordergrundfarbe (i. d. R. die Textfarbe) des Webserversteuerelements festgelegt. (Von WebControl geerbt.)
	HasAttributes	Ruft einen Wert ab, der angibt, ob das Steuerelement Attribute festgelegt wurden. (Von WebControl geerbt.)
	HasChildViewState	Ruft einen Wert ab, der angibt, ob die aktuellen untergeordneten Steuerelemente des Serversteuerelements alle gespeicherten Einstellungen für den Ansichtszustand. (Von Control geerbt.)
	Height	Ruft ab oder legt die Höhe des Webserversteuerelements festgelegt. (Von WebControl geerbt.)
	ID	Ruft den programmgesteuerten Bezeichner ab oder legt ihn fest, der dem Serversteuerelement zugewiesen wird. (Von Control geerbt.)
	IdSeparator	Infrastruktur. Ruft das Zeichen ab, das als Trennzeichen für Steuerelementbezeichner verwendet wird. (Von Control geerbt.)
	IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob die Steuerelemente, die innerhalb dieses Steuerelements enthalten sind, Steuerelementzustand verfügen. (Von Control geerbt.)
	IsEnabled	Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Von WebControl geerbt.)
	IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Von Control geerbt.)
	IsViewStateEnabled	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Von Control geerbt.)
	ItemIndex	Ruft den Index des DataListItem-Objekts aus der Items-Auflistung des Steuerelements ab.
	ItemType	Ruft den Typ des Elements ab, das durch das DataListItem-Objekt im DataList-Steuerelement dargestellt wird.
	LoadViewStateByID	Ruft einen Wert ab, der angibt, ob das Steuerelement geladen sein Ansichtszustand über ID anstelle des Index beteiligt ist. (Von Control geerbt.)
	NamingContainer	Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben Control.ID-Eigenschaftswert erstellt. (Von Control geerbt.)
	Page	Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Von Control geerbt.)
	Parent	Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Von Control geerbt.)
	RenderingCompatibility	Ruft einen Wert ab, der die ASP.NET-Version angibt, ist kompatibel mit der HTML gerendert. (Von Control geerbt.)
	Site	Ruft Informationen über den Container ab, der als Host für das aktuelle Steuerelement, wenn Sie diesen auf einer Entwurfsoberfläche gerendert werden. (Von Control geerbt.)
	SkinID	Ruft die Skin ab, die auf das Steuerelement angewendet werden sollen. (Von WebControl geerbt.)
	Style	Ruft eine Auflistung der Textattribute ab, die als Formatvorlagenattribut auf dem äußeren Tag des Webserversteuerelements gerendert werden. (Von WebControl geerbt.)
	SupportsDisabledAttribute	Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist. (Überschreibt WebControl.SupportsDisabledAttribute.)
	TabIndex	Ruft den Index der Aktivierreihenfolge des Webserversteuerelements festgelegt. (Von WebControl geerbt.)
	TagKey	Ruft den Wert ab HtmlTextWriterTag diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	TagName	Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	TemplateControl	Ruft einen Wert ab oder legt einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält. (Von Control geerbt.)
	TemplateSourceDirectory	Ruft das virtuelle Verzeichnis Page oder des UserControl ab, das das aktuelle Serversteuerelement enthält. (Von Control geerbt.)
	ToolTip	Ruft den Text ab bzw. legt den Text fest, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird. (Von WebControl geerbt.)
	UniqueID	Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Von Control geerbt.)
	ValidateRequestMode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Client Eingaben vom Browser auf gefährliche Werte überprüft werden. (Von Control geerbt.)
	ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, die es Ihnen ermöglicht, zu speichern und den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg wiederherzustellen. (Von Control geerbt.)
	ViewStateIgnoresCase	Ruft einen Wert ab, der angibt, ob das Objekt StateBag die Groß- und Kleinschreibung nicht beachtet wird. (Von Control geerbt.)
	ViewStateMode	Ruft den Text ab oder legt den Ansichtszustandsmodus des Steuerelements fest. (Von Control geerbt.)
	Visible	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Von Control geerbt.)
	Width	Ruft ab oder legt die Breite des Webserversteuerelements festgelegt. (Von WebControl geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddAttributesToRender	Fügt HTML-Attribute und - Stile hinzu, die an das angegebene HtmlTextWriterTaggerendert werden müssen. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	AddedControl	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement wird der Controls-Auflistung des Control-Objekts hinzugefügt. (Von Control geerbt.)
	AddParsedSubObject	Benachrichtigt das Serversteuerelement, dass entweder ein XML- oder ein HTML-Element analysiert, und das Element dem ControlCollection-Objekt des Serversteuerelements hinzugefügt wurde. (Von Control geerbt.)
	ApplyStyle	Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	ApplyStyleSheetSkin	Übernimmt die im Stylesheet der Seite die Stileigenschaften für das Steuerelement. (Von Control geerbt.)
	BeginRenderTracing	Startet die Netzwerkablaufverfolgung Rendern von Daten. (Von Control geerbt.)
	BuildProfileTree	Infrastruktur. Erfasst Informationen über das Serversteuerelement und übermittelt sie an die wenn die Ablaufverfolgung angezeigt werden soll, Trace-Eigenschaft für die Seite aktiviert ist. (Von Control geerbt.)
	ClearCachedClientID	Infrastruktur. Legt den zwischengespeicherten ClientIDnullWert fest. (Von Control geerbt.)
	ClearChildControlState	Löscht die Steuerelementzustandsinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
	ClearChildState	Löscht den Ansichtszustand und die Steuerelementzustandsinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
	ClearChildViewState	Löscht die Ansichtszustandsinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
	ClearEffectiveClientIDMode	Infrastruktur. Legt die ClientIDMode-Eigenschaft der aktuelle Objektinstanz und aller untergeordneten Steuerelemente zu Inheritfest. (Von Control geerbt.)
	CopyBaseAttributes	Kopiert die Eigenschaften, die nicht über das vom angegebenen Objekt Style Webserversteuerelement in das Webserversteuerelement gekapselt werden, aus der diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	CreateChildControls	Wird vom ASP.NET-Seitenframework verwendet, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie enthalten zur Vorbereitung auf Aufgaben wieder oder - Rendering. (Von Control geerbt.)
	CreateControlCollection	Erstellt ein neues Objekt ControlCollection, die untergeordneten Steuerelemente (Literal und Server) des Serversteuerelements enthält. (Von Control geerbt.)
	CreateControlStyle	Erstellt ein TableItemStyle-Objekt für das DataListItem-Steuerelement, das die Stileigenschaften für das Steuerelement enthält. (Überschreibt WebControl.CreateControlStyle().)
	DataBind()	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und an seine untergeordneten Steuerelemente. (Von Control geerbt.)
	DataBind(Boolean)	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und an seine untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Von Control geerbt.)
	DataBindChildren	Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
	Dispose	Aktiviert ein Serversteuerelement, um letzten Bereinigung auszuführen, bevor er aus dem Speicher freigegeben wird. (Von Control geerbt.)
	EndRenderTracing	Beendet die Netzwerkablaufverfolgung Rendern von Daten. (Von Control geerbt.)
	EnsureChildControls	Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, wird die untergeordneten Steuerelemente. (Von Control geerbt.)
	EnsureID	Stellt einen Bezeichner für Steuerelemente, die keinen zugewiesenen Bezeichner verfügen. (Von Control geerbt.)
	Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	FindControl(String)	Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit dem angegebenen id-Parameter. (Von Control geerbt.)
	FindControl(String, Int32)	Infrastruktur. Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, pathOffset im angegebenen Parameter, der in die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben. (Von Control geerbt.)
	Focus	Legt den Eingabefokus auf ein Steuerelement fest. (Von Control geerbt.)
	GetDesignModeState	Infrastruktur. Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Von Control geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetRouteUrl(Object)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
	GetRouteUrl(RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
	GetRouteUrl(String, Object)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
	GetRouteUrl(String, RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetUniqueIDRelativeTo	Gibt den vorangestellten Teil der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Von Control geerbt.)
	HasControls	Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Von Control geerbt.)
	HasEvents	Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement und alle untergeordneten Steuerelemente registriert werden. (Von Control geerbt.)
	IsLiteralContent	Infrastruktur. Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Von Control geerbt.)
	LoadControlState	Stellt die Informationen über den Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState-Methode gespeichert wurden. (Von Control geerbt.)
	LoadViewState	Stellt Ansichtszustandsinformationen von einer vorherigen Anforderung wieder her, die mit der SaveViewState-Methode gespeichert wurden. (Von WebControl geerbt.)
	MapPathSecure	Ruft den physischen Pfad ab, mit dessen Hilfe ein virtueller Pfad absolut oder relativ, Zuordnungen zu. (Von Control geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	MergeStyle	Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, wird jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements überschreiben. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	OnBubbleEvent	Bestimmt, ob das Ereignis für das Steuerelement in der Hierarchie der Serversteuerelemente nach oben übergeben wird. (Überschreibt Control.OnBubbleEvent(Object, EventArgs).)
	OnDataBinding	Löst das DataBinding-Ereignis aus. (Von Control geerbt.)
	OnInit	Löst das Init-Ereignis aus. (Von Control geerbt.)
	OnLoad	Löst das Load-Ereignis aus. (Von Control geerbt.)
	OnPreRender	Löst das PreRender-Ereignis aus. (Von Control geerbt.)
	OnUnload	Löst das Unload-Ereignis aus. (Von Control geerbt.)
	OpenFile	Ruft Stream ab, das verwendet wird, um eine Datei zu lesen. (Von Control geerbt.)
	RaiseBubbleEvent	Weist dem übergeordneten Element alle Quellen des Ereignisses und der Informationen des Steuerelements auf. (Von Control geerbt.)
	RemovedControl	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement wird von der Controls-Auflistung des Control-Objekts entfernt. (Von Control geerbt.)
	Render	Rendert das Steuerelement im angegebenen HTML-Writer. (Von WebControl geerbt.)
	RenderBeginTag	Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	RenderChildren	Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes Objekt aus, das den HtmlTextWriter Rendern auf den Client schreibt Inhalt. (Von Control geerbt.)
	RenderContents	Rendert den Inhalt des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	RenderControl(HtmlTextWriter)	Inhalt serversteuerelement Ausgabe an ein bereitgestelltes HtmlTextWriter-Objekt und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Von Control geerbt.)
	RenderControl(HtmlTextWriter, ControlAdapter)	Inhalt serversteuerelement Ausgabe an ein bereitgestelltes HtmlTextWriter-Objekt mithilfe eines bereitgestellten ControlAdapter-Objekts. (Von Control geerbt.)
	RenderEndTag	Gibt das schließende HTML-Tag des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	RenderItem	Zeigt das DataListItem-Objekt auf dem Client an.
	ResolveAdapter	Ruft den Steuerelementadapter ab, der zum Rendern des angegebenen Steuerelements zuständig ist. (Von Control geerbt.)
	ResolveClientUrl	Ruft eine URL ab, die vom Browser verwendet werden kann. (Von Control geerbt.)
	ResolveUrl	Konvertiert eine URL in das auf dem anfordernden Client verwendet werden kann. (Von Control geerbt.)
	SaveControlState	Speichert alle Änderungen zustands Serversteuerelement Änderungen, die vorgenommen wurden, seit dem Zeitpunkt, zu dem die Seite an den Server zurückgesendet wurde. (Von Control geerbt.)
	SaveViewState	Speichert jeden Zustand, der geändert wurde, nachdem die TrackViewState-Methode aufgerufen wurde. (Von WebControl geerbt.)
	SetDesignModeState	Legt Entwurfszeitdaten für ein Steuerelement fest. (Von Control geerbt.)
	SetItemType	Legt die aktuelle ItemType-Eigenschaft für das DataListItem-Steuerelement fest.
	SetRenderMethodDelegate	Infrastruktur. Weist einen Ereignishandlerdelegaten an, um das Serversteuerelement und seinen Inhalt an das übergeordnete Steuerelement gerendert wird. (Von Control geerbt.)
	SetTraceData(Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeit Netzwerkablaufverfolgung Rendern von Ablaufverfolgungsdaten mithilfe der Daten und des Werts für Ablaufverfolgungsdaten fest. (Von Control geerbt.)
	SetTraceData(Object, Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeit Netzwerkablaufverfolgung Rendern von Daten mit dem aufgezeichneten Objekts, der Ablaufverfolgungsdaten Schlüssels und des Werts Ablaufverfolgungsdaten fest. (Von Control geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
	TrackViewState	Bewirkt, dass das Steuerelement, Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Objekts gespeichert sind. (Von WebControl geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	DataBinding	Tritt ein, wenn das Serversteuerelement an eine Datenquelle gebunden wird. (Von Control geerbt.)
	Disposed	Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird, der die letzte Stufe des Lebenszyklus des Serversteuerelements als eine ASP.NET-Seite angefordert wird. (Von Control geerbt.)
	Init	Tritt ein, wenn sich der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Von Control geerbt.)
	Load	Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Von Control geerbt.)
	PreRender	Tritt auf, nachdem das Control-Objekt, jedoch vor dem Rendern geladen wurde. (Von Control geerbt.)
	Unload	Tritt ein, wenn das Serversteuerelement im Speicher entladen wird. (Von Control geerbt.)

Zum Seitenanfang

Erweiterungsmethoden

	Name	Beschreibung
	EnableDynamicData(Type)	Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
	EnableDynamicData(Type, Object)	Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
	EnableDynamicData(Type, IDictionary<String, Object>)	Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
	FindDataSourceControl	Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. (Durch DynamicDataExtensions definiert.)
	FindFieldTemplate	Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. (Durch DynamicDataExtensions definiert.)
	FindMetaTable	Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. (Durch DynamicDataExtensions definiert.)
	GetDefaultValues	Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab. (Durch DynamicDataExtensions definiert.)
	GetMetaTable	Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab. (Durch DynamicDataExtensions definiert.)
	SetMetaTable(MetaTable)	Überladen. Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
	SetMetaTable(MetaTable, IDictionary<String, Object>)	Überladen. Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
	SetMetaTable(MetaTable, Object)	Überladen. Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
	TryGetMetaTable	Bestimmt, ob Tabellenmetadaten verfügbar sind. (Durch DynamicDataExtensions definiert.)

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

Zum Seitenanfang

Hinweise

Ein DataListItem-Objekt stellt ein Element in einem DataList-Steuerelement dar, z. B. einen Kopfzeilenbereich, einen Fußzeilenbereich oder ein Datenelement.

Die Datenelemente im DataList-Steuerelement sind in einer DataListItemCollection gespeichert, auf die mithilfe der Items-Eigenschaft des DataList-Steuerelements zugegriffen werden kann.

Mit einem DataListItem können Sie programmgesteuert auf die Eigenschaften eines Elements in einem DataList-Steuerelement zugreifen.

Beispiele

Das folgende Beispiel veranschaulicht, wie mit einem DataListItem der Inhalt der einzelnen Datenelemente im DataList-Steuerelement angezeigt wird.

Hinweis
Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine Code-Behind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter ASP.NET Web Page Code Model.



<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">

      ICollection CreateDataSource() 
      {

         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;

         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;

      }


      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once, when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsList.DataSource = CreateDataSource();
            ItemsList.DataBind();
         }

      }

      void Item_Created(Object sender, DataListItemEventArgs e)
      {

         if (e.Item.ItemType == ListItemType.Item || 
             e.Item.ItemType == ListItemType.AlternatingItem)
         {

            // Retrieve the Label control in the current DataListItem.
            Label PriceLabel = (Label)e.Item.FindControl("PriceLabel");

            // Retrieve the text of the CurrencyColumn from the DataListItem
            // and convert the value to a Double.
            Double Price = Convert.ToDouble(
                ((DataRowView)e.Item.DataItem).Row.ItemArray[2].ToString());

            // Format the value as currency and redisplay it in the DataList.
            PriceLabel.Text = Price.ToString("c");

         }

      }

   </script>

<head runat="server">
    <title>DataList ItemCreated Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataList ItemCreated Example</h3>

      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           OnItemCreated="Item_Created"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>

         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: 
            <asp:Label id="PriceLabel"
                 runat="server"/>

         </ItemTemplate>

      </asp:DataList>

   </form>

</body>
</html>

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

System.Web.UI.WebControls-Namespace

DataList

DataListItemCollection

Items

Weitere Ressourcen

DataList Web Server Control Overview

ASP.NET Web Page Code Model

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN

	Name	Beschreibung
	IAttributeAccessor.GetAttribute	Infrastruktur. Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Von WebControl geerbt.)
	IAttributeAccessor.SetAttribute	Legt ein Attribut des Websteuerelements mit dem angegebenen Namen und Wert fest. (Von WebControl geerbt.)
	IControlBuilderAccessor.ControlBuilder	Eine Beschreibung dieses Members finden Sie unter IControlBuilderAccessor.ControlBuilder. (Von Control geerbt.)
	IControlDesignerAccessor.GetDesignModeState	Eine Beschreibung dieses Members finden Sie unter IControlDesignerAccessor.GetDesignModeState. (Von Control geerbt.)
	IControlDesignerAccessor.SetDesignModeState	Eine Beschreibung dieses Members finden Sie unter IControlDesignerAccessor.SetDesignModeState. (Von Control geerbt.)
	IControlDesignerAccessor.SetOwnerControl	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IControlDesignerAccessor.SetOwnerControl. (Von Control geerbt.)
	IControlDesignerAccessor.UserData	Eine Beschreibung dieses Members finden Sie unter IControlDesignerAccessor.UserData. (Von Control geerbt.)
	IDataBindingsAccessor.DataBindings	Eine Beschreibung dieses Members finden Sie unter IDataBindingsAccessor.DataBindings. (Von Control geerbt.)
	IDataBindingsAccessor.HasDataBindings	Eine Beschreibung dieses Members finden Sie unter IDataBindingsAccessor.HasDataBindings. (Von Control geerbt.)
	IDataItemContainer.DataItem	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IDataItemContainer.DataItem.
	IDataItemContainer.DataItemIndex	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IDataItemContainer.DataItemIndex.
	IDataItemContainer.DisplayIndex	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IDataItemContainer.DisplayIndex.
	IExpressionsAccessor.Expressions	Eine Beschreibung dieses Members finden Sie unter IExpressionsAccessor.Expressions. (Von Control geerbt.)
	IExpressionsAccessor.HasExpressions	Eine Beschreibung dieses Members finden Sie unter IExpressionsAccessor.HasExpressions. (Von Control geerbt.)
	IParserAccessor.AddParsedSubObject	Eine Beschreibung dieses Members finden Sie unter IParserAccessor.AddParsedSubObject. (Von Control geerbt.)