(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

DataList-Klasse

Ein datengebundenes Listensteuerelement, das Elemente mithilfe von Vorlagen anzeigt.

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

[ControlValuePropertyAttribute("SelectedValue")]
public class DataList : BaseDataList, INamingContainer, 
	IRepeatInfoUser
<asp:DataList />

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

  NameBeschreibung
Öffentliche MethodeDataListInitialisiert eine neue Instanz der DataList-Klasse.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftAccessKeyRuft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest. (Von WebControl geerbt.)
Geschützte EigenschaftAdapterRuft den browserspezifischen Adapter für das Steuerelement ab. (Von Control geerbt.)
Öffentliche EigenschaftAlternatingItemStyleRuft die Stileigenschaften für abwechselnde Elemente im DataList-Steuerelement ab.
Öffentliche EigenschaftAlternatingItemTemplateRuft die Vorlage für abwechselnde Elemente in DataList ab oder legt diese fest.
Öffentliche EigenschaftAppRelativeTemplateSourceDirectoryRuft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Von Control geerbt.)
Öffentliche EigenschaftAttributesRuft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen. (Von WebControl geerbt.)
Öffentliche EigenschaftBackColorRuft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche EigenschaftBindingContainerInfrastruktur. Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Von Control geerbt.)
Öffentliche EigenschaftBorderColorRuft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche EigenschaftBorderStyleRuft die Rahmenart des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche EigenschaftBorderWidthRuft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche EigenschaftCaptionRuft den Text ab, der in einem HTML-Beschriftungselement im Steuerelement gerendert werden soll, oder legt diesen Text fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Von BaseDataList geerbt.)
Öffentliche EigenschaftCaptionAlignRuft die horizontale oder die vertikale Position des HTML-Beschriftungselements in einem Steuerelement ab oder legt diese fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Von BaseDataList geerbt.)
Öffentliche EigenschaftCellPaddingRuft den Abstand zwischen dem Inhalt einer Zelle und ihrem Rahmen ab oder legt diesen fest. (Von BaseDataList geerbt.)
Öffentliche EigenschaftCellSpacingRuft den Abstand zwischen den Zellen ab oder legt diesen fest. (Von BaseDataList geerbt.)
Geschützte EigenschaftChildControlsCreatedRuft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Von Control geerbt.)
Öffentliche EigenschaftClientIDRuft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Von Control geerbt.)
Öffentliche EigenschaftClientIDModeRuft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest. (Von Control geerbt.)
Geschützte EigenschaftClientIDSeparatorRuft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Von Control geerbt.)
Geschützte EigenschaftContextRuft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Von Control geerbt.)
Öffentliche EigenschaftControlsRuft ein System.Web.UI.ControlCollection-Objekt ab, das eine Auflistung von untergeordneten Steuerelementen eines Datenauflistungssteuerelements enthält. (Von BaseDataList geerbt.)
Öffentliche EigenschaftControlStyleRuft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
Öffentliche EigenschaftControlStyleCreatedRuft 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.)
Öffentliche EigenschaftCssClassRuft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche EigenschaftDataItemContainerRuft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Von Control geerbt.)
Öffentliche EigenschaftDataKeyFieldRuft das Schlüsselfeld in der Datenquelle ab, die von der DataSource-Eigenschaft angegeben wurde, oder legt dieses fest. (Von BaseDataList geerbt.)
Öffentliche EigenschaftDataKeysRuft ein DataKeyCollection-Objekt ab, in dem die Schlüsselwerte aller Datensätze in einem Datenauflistungssteuerelement gespeichert sind. (Von BaseDataList geerbt.)
Geschützte EigenschaftDataKeysArrayRuft ein ArrayList-Objekt ab, in dem die Schlüsselwerte aller Datensätze in einem Datenauflistungssteuerelement enthalten sind. (Von BaseDataList geerbt.)
Öffentliche EigenschaftDataKeysContainerRuft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Von Control geerbt.)
Öffentliche EigenschaftDataMemberRuft in einer Datenquelle mit mehreren Membern einen bestimmten Datenmember ab, der an ein Datenauflistungssteuerelement gebunden werden soll, oder legt diesen fest. (Von BaseDataList geerbt.)
Öffentliche EigenschaftDataSourceRuft die Quelle mit einer Werteliste ab, die zum Auffüllen der Elemente im Steuerelement verwendet wird, oder legt diese fest. (Von BaseDataList geerbt.)
Öffentliche EigenschaftDataSourceIDRuft die ID-Eigenschaft des Datenquellen-Steuerelements ab, von dem das Datenauflistungssteuerelement seine Datenquelle abrufen soll, oder legt diese Eigenschaft fest. (Von BaseDataList geerbt.)
Geschützte EigenschaftDesignModeRuft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Von Control geerbt.)
Öffentliche EigenschaftEditItemIndexRuft die Indexnummer des im DataList-Steuerelement ausgewählten Elements ab, das bearbeitet werden soll, oder legt diese fest.
Öffentliche EigenschaftEditItemStyleRuft die Stileigenschaften für das zur Bearbeitung im DataList-Steuerelement ausgewählte Element ab.
Öffentliche EigenschaftEditItemTemplateRuft die Vorlage für das zur Bearbeitung im DataList-Steuerelement ausgewählte Element ab oder legt diese fest.
Öffentliche EigenschaftEnabledRuft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest. (Von WebControl geerbt.)
Öffentliche EigenschaftEnableThemingRuft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Von WebControl geerbt.)
Öffentliche EigenschaftEnableViewStateRuft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Von Control geerbt.)
Geschützte EigenschaftEventsRuft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Von Control geerbt.)
Öffentliche EigenschaftExtractTemplateRowsRuft einen Wert ab, der angibt, ob die Zeilen eines Table-Steuerelements, die in den einzelnen Vorlagen eines DataList-Steuerelements definiert sind, extrahiert und angezeigt werden, oder legt diesen fest.
Öffentliche EigenschaftFontRuft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Von WebControl geerbt.)
Öffentliche EigenschaftFooterStyleRuft die Stileigenschaften für den Fußzeilenbereich des DataList-Steuerelements ab.
Öffentliche EigenschaftFooterTemplateRuft die Vorlage für den Fußzeilenbereich des DataList-Steuerelements ab oder legt diese fest.
Öffentliche EigenschaftForeColorRuft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche EigenschaftGridLinesRuft den Stil der Rasterlinien für das DataList-Steuerelement ab oder legt diesen fest, wenn die RepeatLayout-Eigenschaft auf RepeatLayout.Table festgelegt ist. (Überschreibt BaseDataList.GridLines.)
Öffentliche EigenschaftHasAttributesRuft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden. (Von WebControl geerbt.)
Geschützte EigenschaftHasChildViewStateRuft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Von Control geerbt.)
Öffentliche EigenschaftHeaderStyleRuft die Stileigenschaften für den Kopfzeilenbereich des DataList-Steuerelements ab.
Öffentliche EigenschaftHeaderTemplateRuft die Vorlage für den Kopfzeilenbereich des DataList-Steuerelements ab oder legt diese fest.
Öffentliche EigenschaftHeightRuft die Höhe des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Öffentliche EigenschaftHorizontalAlignRuft die horizontale Ausrichtung eines Datenauflistungssteuerelements in dessen Container ab oder legt diese fest. (Von BaseDataList geerbt.)
Öffentliche EigenschaftIDRuft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Von Control geerbt.)
Geschützte EigenschaftIdSeparatorInfrastruktur. Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Von Control geerbt.)
Geschützte EigenschaftInitializedRuft einen Wert ab, der angibt, ob das Steuerelement initialisiert wurde. (Von BaseDataList geerbt.)
Geschützte EigenschaftIsBoundUsingDataSourceIDRuft einen Wert ab, der angibt, ob die DataSourceID-Eigenschaft festgelegt ist. (Von BaseDataList geerbt.)
Geschützte EigenschaftIsChildControlStateClearedRuft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Von Control geerbt.)
Geschützte EigenschaftIsEnabledRuft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Von WebControl geerbt.)
Geschützte EigenschaftIsTrackingViewStateRuft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Von Control geerbt.)
Geschützte EigenschaftIsViewStateEnabledRuft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Von Control geerbt.)
Öffentliche EigenschaftItemsRuft eine Auflistung von DataListItem-Objekten ab, die die einzelnen Elemente im Steuerelement darstellen.
Öffentliche EigenschaftItemStyleRuft die Stileigenschaften für die Elemente im DataList-Steuerelement ab.
Öffentliche EigenschaftItemTemplateRuft die Vorlage für die Elemente im DataList-Steuerelement ab oder legt diese fest.
Geschützte EigenschaftLoadViewStateByIDRuft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Von Control geerbt.)
Öffentliche EigenschaftNamingContainerRuft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben Control.ID-Eigenschaftswert unterschieden werden kann. (Von Control geerbt.)
Öffentliche EigenschaftPageRuft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Von Control geerbt.)
Öffentliche EigenschaftParentRuft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Von Control geerbt.)
Öffentliche EigenschaftRenderingCompatibility Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der das gerenderte HTML kompatibel ist. (Von Control geerbt.)
Öffentliche EigenschaftRepeatColumnsRuft die Anzahl der Spalten ab, die im DataList-Steuerelement angezeigt werden, oder legt diese fest.
Öffentliche EigenschaftRepeatDirectionRuft ab oder legt fest, ob das DataList-Steuerelement vertikal oder horizontal angezeigt wird.
Öffentliche EigenschaftRepeatLayoutRuft ab oder legt fest, ob das Steuerelement im Tabellen- oder Flusslayout angezeigt wird.
Geschützte EigenschaftRequiresDataBindingRuft einen Wert ab, der angibt, ob das Datenauflistungssteuerelement an seine angegebene Datenquelle gebunden werden muss, oder legt diesen fest. (Von BaseDataList geerbt.)
Geschützte EigenschaftSelectArgumentsRuft ein DataSourceSelectArguments-Objekt ab, das vom datengebundenen Steuerelement beim Abrufen von Daten aus einem Datenquellen-Steuerelement verwendet wird. (Von BaseDataList geerbt.)
Öffentliche EigenschaftSelectedIndexRuft den Index des ausgewählten Elements im DataList-Steuerelement ab oder legt diesen fest.
Öffentliche EigenschaftSelectedItemRuft das im DataList-Steuerelement ausgewählte Element ab.
Öffentliche EigenschaftSelectedItemStyleRuft die Stileigenschaften für das im DataList-Steuerelement ausgewählte Element ab.
Öffentliche EigenschaftSelectedItemTemplateRuft die Vorlage für das im DataList-Steuerelement ausgewählte Element ab oder legt diese fest.
Öffentliche EigenschaftSelectedValueRuft den Wert des Schlüsselfelds für das ausgewählte Datenlistenelement ab.
Öffentliche EigenschaftSeparatorStyleRuft die Stileigenschaften des Trennzeichens zwischen den Elementen im DataList-Steuerelement ab.
Öffentliche EigenschaftSeparatorTemplateRuft die Vorlage für das Trennzeichen zwischen den Elementen im DataList-Steuerelement ab oder legt diese fest.
Öffentliche EigenschaftShowFooterRuft einen Wert ab, der angibt, ob der Fußzeilenbereich im DataList-Steuerelement angezeigt wird, oder legt diesen fest.
Öffentliche EigenschaftShowHeaderRuft einen Wert ab, der angibt, ob der Headerbereich im DataList-Steuerelement angezeigt wird, oder legt diesen fest.
Öffentliche EigenschaftSiteRuft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Von Control geerbt.)
Öffentliche EigenschaftSkinIDRuft die Skin ab, die auf das Steuerelement angewendet werden soll, oder legt diese fest. (Von WebControl geerbt.)
Öffentliche EigenschaftStyleRuft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden. (Von WebControl geerbt.)
Öffentliche EigenschaftSupportsDisabledAttributeRuft 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. (Von BaseDataList geerbt.)
Öffentliche EigenschaftTabIndexRuft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest. (Von WebControl geerbt.)
Geschützte EigenschaftTagKeyRuf das HTML-Tag ab, das zum Rendern des DataList-Steuerelements verwendet wird. (Überschreibt WebControl.TagKey.)
Geschützte EigenschaftTagNameRuft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
Öffentliche EigenschaftTemplateControlRuft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Von Control geerbt.)
Öffentliche EigenschaftTemplateSourceDirectoryRuft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Von Control geerbt.)
Öffentliche EigenschaftToolTipRuft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest. (Von WebControl geerbt.)
Öffentliche EigenschaftUniqueIDRuft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Von Control geerbt.)
Öffentliche EigenschaftUseAccessibleHeaderRuft einen Wert ab, der angibt, ob das Datenauflistungssteuerelement den zugehörigen Header in einem barrierefreien Format rendert, oder legt diesen Wert fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern. (Von BaseDataList geerbt.)
Geschützte EigenschaftViewStateRuft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Von Control geerbt.)
Geschützte EigenschaftViewStateIgnoresCaseRuft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Von Control geerbt.)
Öffentliche EigenschaftViewStateModeRuft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Von Control geerbt.)
Öffentliche EigenschaftVisibleRuft einen Wert ab, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite dargestellt wird, oder legt diesen fest. (Von Control geerbt.)
Öffentliche EigenschaftWidthRuft die Breite des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
Zum Seitenanfang

  NameBeschreibung
Geschützte MethodeAddAttributesToRenderFügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Formatvorlagen hinzu. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte MethodeAddedControlWird aufgerufen, nachdem ein untergeordnetes Steuerelement der Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Von Control geerbt.)
Geschützte MethodeAddParsedSubObjectBenachrichtigt das Serversteuerelement, dass entweder ein XML- oder ein HTML-Element analysiert wurde, und fügt das Element der ControlCollection-Auflistung des Serversteuerelements hinzu. (Von BaseDataList geerbt.)
Öffentliche MethodeApplyStyleKopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
Öffentliche MethodeApplyStyleSheetSkinÜbernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Von Control geerbt.)
Geschützte MethodeBuildProfileTreeInfrastruktur. Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Von Control geerbt.)
Geschützte MethodeClearCachedClientIDInfrastruktur. Legt den zwischengespeicherten ClientID-Wert auf null fest. (Von Control geerbt.)
Geschützte MethodeClearChildControlStateLöscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte MethodeClearChildStateLöscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte MethodeClearChildViewStateLöscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte MethodeClearEffectiveClientIDModeInfrastruktur. Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Von Control geerbt.)
Öffentliche MethodeCopyBaseAttributesKopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte MethodeCreateChildControlsInfrastruktur. Erstellt ein untergeordnetes Steuerelement unter Verwendung des Ansichtszustands. (Von BaseDataList geerbt.)
Geschützte MethodeCreateControlCollectionErstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (literale und Serversteuerelemente) des Serversteuerelements aufnehmen soll. (Von Control geerbt.)
Geschützte MethodeCreateControlHierarchyErstellt die Steuerelementhierarchie, die zum Rendern des Datenlistensteuerelements mit oder ohne die angegebene Datenquelle verwendet wird. (Überschreibt BaseDataList.CreateControlHierarchy(Boolean).)
Geschützte MethodeCreateControlStyleErstellt das Standardformatvorlagenobjekt, das von der DataList-Klasse intern zum Implementieren aller auf Formatvorlagen bezogenen Eigenschaften verwendet wird. (Überschreibt WebControl.CreateControlStyle().)
Geschützte MethodeCreateDataSourceSelectArgumentsErstellt ein vom datengebundenen Steuerelement verwendetes DataSourceSelectArguments-Standardobjekt, wenn keine Argumente angegeben wurden. (Von BaseDataList geerbt.)
Geschützte MethodeCreateItemErstellt ein DataListItem-Objekt.
Öffentliche MethodeDataBind()Bindet das Steuerelement und alle seine untergeordneten Steuerelemente an die angegebene Datenquelle. (Von BaseDataList geerbt.)
Geschützte MethodeDataBind(Boolean)Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Von Control geerbt.)
Geschützte MethodeDataBindChildrenBindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Öffentliche MethodeDisposeErmöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Von Control geerbt.)
Geschützte MethodeEnsureChildControlsStellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Von Control geerbt.)
Geschützte MethodeEnsureDataBoundÜberprüft vor dem Aufrufen der DataBind-Methode, ob für das Datenauflistungssteuerelement eine Datenbindung erforderlich ist und ob ein gültiges Datenquellen-Steuerelement angegeben wurde. (Von BaseDataList geerbt.)
Geschützte MethodeEnsureIDErstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Von Control geerbt.)
Öffentliche MethodeEquals(Object) Bestimmt, ob das übergegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeFindControl(String)Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter. (Von Control geerbt.)
Geschützte MethodeFindControl(String, Int32)Infrastruktur. Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben. (Von Control geerbt.)
Öffentliche MethodeFocusLegt den Eingabefokus auf ein Steuerelement fest. (Von Control geerbt.)
Geschützte MethodeGetDataGibt ein durch IEnumerable implementiertes Objekt zurück, das die Datenquelle darstellt. (Von BaseDataList geerbt.)
Geschützte MethodeGetDesignModeStateInfrastruktur. Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Von Control geerbt.)
Öffentliche MethodeGetHashCodeFungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche MethodeGetRouteUrl(Object)Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
Öffentliche MethodeGetRouteUrl(RouteValueDictionary)Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
Öffentliche MethodeGetRouteUrl(String, Object)Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
Öffentliche MethodeGetRouteUrl(String, RouteValueDictionary)Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeGetUniqueIDRelativeToGibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Von Control geerbt.)
Öffentliche MethodeHasControlsErmittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Von Control geerbt.)
Geschützte MethodeHasEventsGibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Von Control geerbt.)
Geschützte MethodeInitializeItemInitialisiert auf der Grundlage der angegebenen Vorlagen und Stile für den Listenelementtyp ein DataListItem-Objekt.
Geschützte MethodeIsLiteralContentInfrastruktur. Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Von Control geerbt.)
Geschützte MethodeLoadControlStateStellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState-Methode gespeichert wurden. (Von Control geerbt.)
Geschützte MethodeLoadViewStateLädt den zuvor gespeicherten Ansichtszustand des DataList-Steuerelements. (Überschreibt WebControl.LoadViewState(Object).)
Geschützte MethodeMapPathSecureRuft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Von Control geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeMergeStyleKopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte MethodeOnBubbleEventBestimmt, ob das Ereignis für das Serversteuerelement in der Serversteuerelementhierarchie der Benutzeroberfläche der Seite nach oben weitergegeben wird. (Überschreibt Control.OnBubbleEvent(Object, EventArgs).)
Geschützte MethodeOnCancelCommandLöst das CancelCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte MethodeOnDataBindingInfrastruktur. Löst das DataBinding-Ereignis eines BaseDataList-Steuerelements aus. (Von BaseDataList geerbt.)
Geschützte MethodeOnDataPropertyChangedWird aufgerufen, wenn eine der Identifikationseigenschaften der Basisdatenquelle geändert wird, um das datengebundene Steuerelement erneut an seine Daten zu binden. (Von BaseDataList geerbt.)
Geschützte MethodeOnDataSourceViewChangedLöst das DataSourceViewChanged-Ereignis aus. (Von BaseDataList geerbt.)
Geschützte MethodeOnDeleteCommandLöst das DeleteCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte MethodeOnEditCommandLöst das EditCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte MethodeOnInitLöst das Init-Ereignis für das DataList-Steuerelement aus. (Überschreibt BaseDataList.OnInit(EventArgs).)
Geschützte MethodeOnItemCommandLöst das ItemCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte MethodeOnItemCreatedLöst das ItemCreated-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte MethodeOnItemDataBoundLöst das ItemDataBound-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte MethodeOnLoadInfrastruktur. Löst das Load-Ereignis aus. (Von BaseDataList geerbt.)
Geschützte MethodeOnPreRenderInfrastruktur. Löst das PreRender-Ereignis aus. (Von BaseDataList geerbt.)
Geschützte MethodeOnSelectedIndexChangedLöst das SelectedIndexChanged-Ereignis eines BaseDataList-Steuerelements aus. (Von BaseDataList geerbt.)
Geschützte MethodeOnUnloadLöst das Unload-Ereignis aus. (Von Control geerbt.)
Geschützte MethodeOnUpdateCommandLöst das UpdateCommand-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Geschützte MethodeOpenFileRuft einen Stream zum Lesen einer Datei ab. (Von Control geerbt.)
Geschützte MethodePrepareControlHierarchyBereitet die Steuerelementhierarchie für das Rendern im DataList-Steuerelement vor. (Überschreibt BaseDataList.PrepareControlHierarchy().)
Geschützte MethodeRaiseBubbleEventWeist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Von Control geerbt.)
Geschützte MethodeRemovedControlWird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Von Control geerbt.)
Geschützte MethodeRenderInfrastruktur. Gibt das Steuerelement im angegebenen HTML-Writer wieder. (Von BaseDataList geerbt.)
Öffentliche MethodeRenderBeginTagGibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte MethodeRenderChildrenGibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt. (Von Control geerbt.)
Geschützte MethodeRenderContentsGibt die Listenelemente im DataList-Steuerelement wieder. (Überschreibt WebControl.RenderContents(HtmlTextWriter).)
Öffentliche MethodeRenderControl(HtmlTextWriter)Gibt den Inhalt des Serversteuerelements an ein angegebenes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Von Control geerbt.)
Geschützte MethodeRenderControl(HtmlTextWriter, ControlAdapter)Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten ControlAdapter-Objekts an ein bereitgestelltes HtmlTextWriter-Objekt aus. (Von Control geerbt.)
Öffentliche MethodeRenderEndTagStellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
Geschützte MethodeResolveAdapterRuft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Von Control geerbt.)
Öffentliche MethodeResolveClientUrlRuft eine URL ab, die vom Browser verwendet werden kann. (Von Control geerbt.)
Öffentliche MethodeResolveUrlKonvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Von Control geerbt.)
Geschützte MethodeSaveControlStateSpeichert alle Änderungen am Zustand des Serversteuerelements, die seit dem letzten Postback der Seite an den Server aufgetreten sind. (Von Control geerbt.)
Geschützte MethodeSaveViewStateSpeichert die Änderungen am Ansichtszustand des Steuerelements ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Überschreibt WebControl.SaveViewState().)
Geschützte MethodeSetDesignModeStateLegt Entwurfszeitdaten für ein Steuerelement fest. (Von Control geerbt.)
Öffentliche MethodeSetRenderMethodDelegateInfrastruktur. Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Von Control geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Geschützte MethodeTrackViewStateVerfolgt die am Ansichtszustand des DataList-Steuerelements vorgenommenen Änderungen und speichert diese in der ViewState-Eigenschaft des Steuerelements. (Überschreibt WebControl.TrackViewState().)
Zum Seitenanfang

  NameBeschreibung
Öffentliches EreignisCancelCommandTritt ein, wenn auf die Schaltfläche Cancel für ein Element im DataList-Steuerelement geklickt wird.
Öffentliches EreignisDataBindingTritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Von Control geerbt.)
Öffentliches EreignisDeleteCommandTritt ein, wenn auf die Schaltfläche Delete für ein Element im DataList-Steuerelement geklickt wird.
Öffentliches EreignisDisposedTritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Von Control geerbt.)
Öffentliches EreignisEditCommandTritt ein, wenn auf die Schaltfläche Edit für ein Element im DataList-Steuerelement geklickt wird.
Öffentliches EreignisInitTritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Von Control geerbt.)
Öffentliches EreignisItemCommandTritt ein, wenn auf eine beliebige Schaltfläche im DataList-Steuerelement geklickt wird.
Öffentliches EreignisItemCreatedTritt auf dem Server ein, wenn im DataList-Steuerelement ein Element erstellt wird.
Öffentliches EreignisItemDataBoundTritt ein, wenn ein Element an das DataList-Steuerelement datengebunden wird.
Öffentliches EreignisLoadTritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Von Control geerbt.)
Öffentliches EreignisPreRenderTritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Von Control geerbt.)
Öffentliches EreignisSelectedIndexChangedTritt ein, wenn in einem Datenauflistungssteuerelement zwischen Übermittlungen zum Server ein anderes Element ausgewählt wird. (Von BaseDataList geerbt.)
Öffentliches EreignisUnloadTritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Von Control geerbt.)
Öffentliches EreignisUpdateCommandTritt ein, wenn auf die Schaltfläche Update für ein Element im DataList-Steuerelement geklickt wird.
Zum Seitenanfang

  NameBeschreibung
Öffentliche ErweiterungsmethodeEnableDynamicData(Type)Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
Öffentliche ErweiterungsmethodeEnableDynamicData(Type, Object)Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
Öffentliche ErweiterungsmethodeEnableDynamicData(Type, IDictionary<String, Object>)Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
Öffentliche ErweiterungsmethodeFindDataSourceControlGibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeFindFieldTemplateGibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeFindMetaTableGibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeGetDefaultValuesRuft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeGetMetaTableRuft die Tabellenmetadaten für das angegebene Datensteuerelement ab. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeSetMetaTable(MetaTable)Überladen. Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeSetMetaTable(MetaTable, IDictionary<String, Object>)Überladen. Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeSetMetaTable(MetaTable, Object)Überladen. Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
Öffentliche ErweiterungsmethodeTryGetMetaTableBestimmt, ob Tabellenmetadaten verfügbar sind. (Durch DynamicDataExtensions definiert.)
Zum Seitenanfang

  NameBeschreibung
Öffentliches FeldStatischer MemberCancelCommandNameStellt den Namen des Cancel-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches FeldStatischer MemberDeleteCommandNameStellt den Namen des Delete-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches FeldStatischer MemberEditCommandNameStellt den Namen des Edit-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches FeldStatischer MemberSelectCommandNameStellt den Namen des Select-Befehls dar. Dieses Feld ist schreibgeschützt.
Öffentliches FeldStatischer MemberUpdateCommandNameStellt den Namen des Update-Befehls dar. Dieses Feld ist schreibgeschützt.
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeIAttributeAccessor.GetAttributeInfrastruktur. Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Von WebControl geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIAttributeAccessor.SetAttributeLegt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest. (Von WebControl geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIControlBuilderAccessor.ControlBuilderEine Beschreibung dieses Members finden Sie unter der IControlBuilderAccessor.ControlBuilder-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIControlDesignerAccessor.GetDesignModeStateEine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.GetDesignModeState-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIControlDesignerAccessor.SetDesignModeStateEine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.SetDesignModeState-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIControlDesignerAccessor.SetOwnerControlInfrastruktur. Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.SetOwnerControl-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIControlDesignerAccessor.UserDataEine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.UserData-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIDataBindingsAccessor.DataBindingsEine Beschreibung dieses Members finden Sie unter der IDataBindingsAccessor.DataBindings-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIDataBindingsAccessor.HasDataBindingsEine Beschreibung dieses Members finden Sie unter der IDataBindingsAccessor.HasDataBindings-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIExpressionsAccessor.ExpressionsEine Beschreibung dieses Members finden Sie unter der IExpressionsAccessor.Expressions-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate EigenschaftIExpressionsAccessor.HasExpressionsEine Beschreibung dieses Members finden Sie unter der IExpressionsAccessor.HasExpressions-Methode. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIParserAccessor.AddParsedSubObjectEine Beschreibung dieses Members finden Sie unter IParserAccessor.AddParsedSubObject. (Von Control geerbt.)
Explizite SchnittstellenimplementierungPrivate MethodeIRepeatInfoUser.GetItemStyleInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IRepeatInfoUser.GetItemStyle.
Explizite SchnittstellenimplementierungPrivate EigenschaftIRepeatInfoUser.HasFooterInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IRepeatInfoUser.HasFooter.
Explizite SchnittstellenimplementierungPrivate EigenschaftIRepeatInfoUser.HasHeaderInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IRepeatInfoUser.HasHeader.
Explizite SchnittstellenimplementierungPrivate EigenschaftIRepeatInfoUser.HasSeparatorsInfrastruktur. Eine Beschreibung dieses Members finden Sie unter der IRepeatInfoUser.HasSeparators-Methode.
Explizite SchnittstellenimplementierungPrivate MethodeIRepeatInfoUser.RenderItemInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IRepeatInfoUser.RenderItem.
Explizite SchnittstellenimplementierungPrivate EigenschaftIRepeatInfoUser.RepeatedItemCountInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IRepeatInfoUser.RepeatedItemCount.
Zum Seitenanfang

In diesem Thema:

Einführung

Mit dem DataList-Steuerelement können Sie eine mithilfe von Vorlagen definierte, datengebundene Liste anzeigen. Das DataList-Steuerelement unterstützt das Auswählen und Bearbeiten.

Vorlagen

Der Inhalt des DataList-Steuerelements kann mithilfe von Vorlagen geändert werden. In der folgenden Tabelle sind die unterstützten Vorlagen aufgelistet.

Vorlagenname

Beschreibungen

AlternatingItemTemplate

Stellt (sofern definiert) den Inhalt und das Layout für abwechselnde Elemente in DataList bereit. Wenn nicht definiert, wird ItemTemplate verwendet.

EditItemTemplate

Stellt (sofern definiert) den Inhalt und das Layout für das gegenwärtig bearbeitete Element in DataList bereit. Wenn nicht definiert, wird ItemTemplate verwendet.

FooterTemplate

Stellt (sofern definiert) den Inhalt und das Layout für den Fußzeilenbereich in DataList bereit. Wenn diese Vorlage nicht definiert ist, wird kein Fußzeilenbereich angezeigt.

HeaderTemplate

Stellt (sofern definiert) den Inhalt und das Layout für den Kopfzeilenbereich in DataList bereit. Wenn diese Vorlage nicht definiert ist, wird kein Kopfzeilenbereich angezeigt.

ItemTemplate

Diese Vorlage muss definiert sein. Sie stellt den Inhalt und das Layout für Elemente in DataList bereit.

SelectedItemTemplate

Stellt (sofern definiert) den Inhalt und das Layout für das gegenwärtig ausgewählte Element in DataList bereit. Wenn nicht definiert, wird ItemTemplate verwendet.

SeparatorTemplate

Stellt (sofern definiert) den Inhalt und das Layout für das Trennzeichen zwischen Elementen in DataList bereit. Wenn diese Vorlage nicht definiert ist, wird kein Trennzeichen angezeigt.

Damit die Elemente im DataList-Steuerelement angezeigt werden können, muss zumindest ItemTemplate definiert sein. Mit zusätzlichen Vorlagen kann ein benutzerdefiniertes Erscheinungsbild für das DataList-Steuerelement bereitgestellt werden.

Anpassen der Darstellung des DataList-Steuerelements

Die Darstellung des DataList-Steuerelements kann durch Festlegen der Stileigenschaften für die unterschiedlichen Teile des Steuerelements angepasst werden. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgelistet.

Style-Eigenschaft

Beschreibungen

AlternatingItemStyle

Gibt den Stil für abwechselnde Elemente im DataList-Steuerelement an.

EditItemStyle

Gibt den Stil für das im DataList-Steuerelement bearbeitete Element an.

FooterStyle

Gibt den Stil für die Fußzeile im DataList-Steuerelement an.

HeaderStyle

Gibt den Stil für den Header im DataList-Steuerelement an.

ItemStyle

Gibt den Stil für die Elemente im DataList-Steuerelement an.

SelectedItemStyle

Gibt den Stil für das im DataList-Steuerelement ausgewählte Element an.

SeparatorStyle

Gibt den Stil für das Trennzeichen zwischen den Elementen im DataList-Steuerelement an.

Sie können auch verschiedene Bereiche des Steuerelements anzeigen und ausblenden. In der folgenden Tabelle sind die Eigenschaften aufgeführt, mit denen gesteuert wird, welche Bereiche angezeigt oder ausgeblendet werden.

Property

Beschreibungen

ShowFooter

Zeigt den Fußzeilenbereich des DataList-Steuerelements an oder blendet diesen aus.

ShowHeader

Zeigt den Kopfzeilenbereich des DataList-Steuerelements an oder blendet diesen aus.

Anzeigen von Richtung und Layout

Die Anzeigerichtung eines DataList-Steuerelements kann vertikal bzw. horizontal sein. Legen Sie zum Angeben der Anzeigerichtung die RepeatDirection-Eigenschaft fest.

Das Layout des DataList-Steuerelements wird durch die RepeatLayout-Eigenschaft gesteuert. Wenn diese Eigenschaft auf RepeatLayout.Table festgelegt wird, erfolgt die Anzeige von DataList im Tabellenformat, beim Festlegen auf RepeatLayout.Flow wird DataList dagegen ohne Tabellenstruktur angezeigt.

Sicherheit

Das DataList-Steuerelement kann Steuerelemente enthalten, die es Benutzern ermöglichen, Informationen einzugeben.

WarnhinweisVorsicht

Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die möglicherweise böswillige Clientskripts enthalten. Überprüfen Sie alle Informationen, die von einem Client gesendet werden, nach ausführbaren Skripts, SQL-Anweisungen oder anderem Code, bevor Sie sie in der Anwendung anzeigen. Bevor der Eingabetext in einem Steuerelement angezeigt wird, können Sie mit Validierungssteuerelementen die Benutzereingaben überprüfen. ASP.NET stellt ein Validierungsfeature für Eingabeaufforderungen bereit, um Skripts und HTML in Benutzereingaben zu blockieren.

Weitere Informationen über Sicherheit finden Sie unter Sichern von Standardsteuerelementen, Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen und Überprüfen der Benutzereingabe in ASP.NET-Webseiten.

Deklarative Syntax

<asp:DataList
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyField="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditItemIndex="integer"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ExtractTemplateRows="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnCancelCommand="CancelCommand event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleteCommand="DeleteCommand event handler"
    OnDisposed="Disposed event handler"
    OnEditCommand="EditCommand event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnUnload="Unload event handler"
    OnUpdateCommand="UpdateCommand event handler"
    RepeatColumns="integer"
    RepeatDirection="Horizontal|Vertical"
    RepeatLayout="Table|Flow"
    runat="server"
    SelectedIndex="integer"
    ShowFooter="True|False"
    ShowHeader="True|False"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    UseAccessibleHeader="True|False"
    Visible="True|False"
    Width="size"
>
        <AlternatingItemStyle />
        <AlternatingItemTemplate>
            <!-- child controls -->
        </AlternatingItemTemplate>
        <EditItemStyle />
        <EditItemTemplate>
            <!-- child controls -->
        </EditItemTemplate>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <ItemStyle />
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <SelectedItemStyle />
        <SelectedItemTemplate>
            <!-- child controls -->
        </SelectedItemTemplate>
        <SeparatorStyle />
        <SeparatorTemplate>
            <!-- child controls -->
        </SeparatorTemplate>
</asp:DataList>

TopicLocation
Gewusst wie: Erstellen von Vorlagen für ASP.NET-WebserversteuerelementeErstellen von ASP.NET-Webanwendungen
Gewusst wie: Dynamisches Anpassen von Elementen im DataList-WebserversteuerelementErstellen von ASP.NET-Webanwendungen
Gewusst wie: Hinzufügen von DataList-Steuerelementen zu einer ASP.NET-WebseiteErstellen von ASP.NET-Webanwendungen
Gewusst wie: Deklaratives Erstellen von Vorlagen für ASP.NET-WebsteuerelementeErstellen von ASP.NET-Webanwendungen
Gewusst wie: Angeben des horizontalen oder vertikalen Layouts in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen
Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Hinzufügen von Steuerelementen zu einer ASP.NET-WebseiteErstellen von ASP.NET-Webanwendungen
Gewusst wie: Dynamisches Erstellen von Vorlagen für ASP.NET-WebserversteuerelementeErstellen von ASP.NET-Webanwendungen
Gewusst wie: Ermöglichen des Bearbeitens von Elementen in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen
Gewusst wie: Binden an Daten in einem vorlagenbasierten SteuerelementErstellen von ASP.NET-Webanwendungen
Gewusst wie: Anpassen von DataList-Elementen zur LaufzeitErstellen von ASP.NET-Webanwendungen
Gewusst wie: Ermöglichen des Auswählens von Elementen in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen
Gewusst wie: Reagieren auf Schaltflächenereignisse in DataList-, Repeater- oder GridView-ElementenErstellen von ASP.NET-Webanwendungen
Gewusst wie: Angeben von Fluss- oder Tabellenformat in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen
Gewusst wie: Reagieren auf Schaltflächenereignisse in datengebundenen SteuerelementenErstellen von ASP.NET-Webanwendungen
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web DeveloperErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen und Formatieren von Daten mit dem DataList-Webserver-SteuerelementErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Erstellen von Vorlagen für Webserver-Steuerelemente mithilfe des DesignersErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer Webseite zum Anzeigen von XML-DatenErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes GeschäftsobjektErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von DataList-Webserversteuerelementen zu einer ASP.NET-Webseite (Visual Studio)Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen eines XML-Dokuments in einer Web Forms-Seite mithilfe von TransformationenErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement in Visual StudioErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen von Master-Detail-Webseiten in Visual StudioErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Dynamisches Anpassen von Elementen im DataList-WebserversteuerelementErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web DeveloperErstellen von Anwendungen mit Visual Web Developer
Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Deklaratives Erstellen von Vorlagen für ASP.NET-WebsteuerelementeErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Angeben des horizontalen oder vertikalen Layouts in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Hinzufügen von Steuerelementen zu einer ASP.NET-WebseiteErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen und Formatieren von Daten mit dem DataList-WebserversteuerelementErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Erstellen von Vorlagen für Webserver-Steuerelemente mithilfe des DesignersErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Dynamisches Erstellen von Vorlagen für ASP.NET-WebserversteuerelementeErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Ermöglichen des Bearbeitens von Elementen in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer Webseite zum Anzeigen von XML-DatenErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Binden an Daten in einem vorlagenbasierten SteuerelementErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes GeschäftsobjektErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Ermöglichen des Auswählens von Elementen in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von DataList-Webserversteuerelementen zu einer ASP.NET-WebseiteErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anpassen von DataList-Elementen zur LaufzeitErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement in Visual StudioErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen von Master-Detail-Webseiten in Visual StudioErstellen von Anwendungen mit Visual Web Developer
Gewusst wie: Reagieren auf Schaltflächenereignisse in datengebundenen SteuerelementenErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Angeben von Fluss- oder Tabellenformat in DataList-WebserversteuerelementenErstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf Schaltflächenereignisse in DataList- oder Repeater-ElementenErstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen eines XML-Dokuments in einer Web Forms-Seite mithilfe von TransformationenErstellen von ASP.NET-Webanwendungen in Visual Studio

Im folgenden Beispiel wird das Anzeigen einer Liste von Elementen aus einer Datenquelle mit einem DataList-Steuerelement veranschaulicht.

HinweisHinweis

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 Codemodell für ASP.NET-Webseiten.



<%@ 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)));
         dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));

         // 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);
            dr[3] = "Image" + i.ToString() + ".jpg";

            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();
         }

      }

   </script>

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

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

      <h3>DataList Example</h3>

      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           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: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>

      </asp:DataList>

   </form>

</body>
</html>



.NET Framework

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

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

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

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

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft