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.

ListControl-Klasse

.NET Framework 4.5

Andere Versionen

Fungiert als die abstrakte Basisklasse, in der die Eigenschaften, Methoden und Ereignisse definiert sind, die allen Steuerelementen vom Typ Liste gemeinsam sind.

Vererbungshierarchie

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.ListControl
            System.Web.UI.WebControls.BulletedList
            System.Web.UI.WebControls.CheckBoxList
            System.Web.UI.WebControls.DropDownList
            System.Web.UI.WebControls.ListBox
            System.Web.UI.WebControls.RadioButtonList

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

Syntax

C++

[ControlValuePropertyAttribute("SelectedValue")]
public abstract class ListControl : DataBoundControl, 
	IEditableTextControl, ITextControl

ASP.NET

<asp:ListControl />

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

Konstruktoren

	Name	Beschreibung
	ListControl	Initialisiert eine neue Instanz der ListControl-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.)
	AppendDataBoundItems	Ruft einen Wert ab, der angibt, ob Listenelemente vor der Datenbindung gelöscht werden, oder legt diesen Wert fest.
	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.)
	AutoPostBack	Ruft einen Wert ab, der angibt, ob ein automatisches Postback an den Server erfolgt, wenn der Benutzer die Listenauswahl ändert, oder legt diesen fest.
	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.)
	CausesValidation	Ruft einen Wert ab, der angibt, ob beim Klicken auf ein Steuerelement, das von der ListControl-Klasse abgeleitet ist, eine Validierung durchgeführt wird, oder legt diesen fest.
	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.)
	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.)
	DataMember	Ruft den Namen der Datenliste ab, an die das datengebundene Steuerelement gebunden wird, wenn die Datenquelle mehrere Listen von Datenelementen enthält, oder legt diesen fest. (Von DataBoundControl geerbt.)
	DataSource	Ruft das Objekt ab, aus dem das datengebundene Steuerelement seine Liste mit Datenelementen abruft. (Von BaseDataBoundControl geerbt.)
	DataSourceID	Ruft die ID des Steuerelements ab, aus dem das datengebundene Steuerelement seine Liste mit Datenelementen abruft, oder legt diese fest. (Von DataBoundControl geerbt.)
	DataSourceObject	Ruft ein Objekt ab, das die IDataSource-Schnittstelle implementiert, die Zugriff auf den Dateninhalt des Objekts bereitstellt. (Von DataBoundControl geerbt.)
	DataTextField	Ruft das Feld der Datenquelle ab, das den Textinhalt der Listenelemente bereitstellt, oder legt dieses fest.
	DataTextFormatString	Ruft die Formatierungszeichenfolge ab, mit der die Anzeige der mit dem Listensteuerelement verbundenen Daten gesteuert wird, oder legt diese fest.
	DataValueField	Ruft das Feld der Datenquelle ab, das den Wert für jedes Listenelement bereitstellt, oder legt dieses fest.
	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.)
	Initialized	Ruft einen Wert ab, der angibt, ob das datengebundene Steuerelement initialisiert wurde. (Von BaseDataBoundControl geerbt.)
	IsBoundUsingDataSourceID	Ruft einen Wert ab, der angibt, ob die DataSourceID-Eigenschaft festgelegt ist. (Von BaseDataBoundControl geerbt.)
	IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob die Steuerelemente, die innerhalb dieses Steuerelements enthalten sind, Steuerelementzustand verfügen. (Von Control geerbt.)
	IsDataBindingAutomatic	Ruft einen Wert ab, der angibt, ob Datenbindung automatisch ist. (Von BaseDataBoundControl 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.)
	IsUsingModelBinders	Ruft einen Wert ab, der angibt, ob das Modell Assemblybindung verwendet wird. (Von DataBoundControl geerbt.)
	IsViewStateEnabled	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Von Control geerbt.)
	Items	Ruft die Auflistung der Elemente im Listensteuerelement ab.
	ItemType	Ruft den Namen des Typs Datenelement für die Datenbindung mit strikter Typbindung fest. (Von DataBoundControl geerbt.)
	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.)
	RequiresDataBinding	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die DataBind-Methode aufgerufen werden soll. (Von BaseDataBoundControl geerbt.)
	SelectArguments	Ruft ein DataSourceSelectArguments-Objekt ab, das vom datengebundenen Steuerelement beim Abrufen von Daten aus einem Datenquellen-Steuerelement verwendet wird. (Von DataBoundControl geerbt.)
	SelectedIndex	Ruft den niedrigsten Ordinalindex der in der Liste ausgewählten Elemente ab oder legt diesen fest.
	SelectedItem	Ruft das im Steuerelement ausgewählte Element mit dem niedrigsten Index ab.
	SelectedValue	Ruft den Wert des ausgewählten Elements im Listensteuerelement ab oder wählt das Element im Listensteuerelement aus, das den angegebenen Wert enthält.
	SelectMethod	Der Name der aufzurufenden Methode Daten gelesen werden. (Von DataBoundControl 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 das Steuerelement das disabled-Attribut des gerenderten HTML-Elements“ Deaktiviert „festlegen soll, wenn die IsEnabled-Eigenschaft des Steuerelements falseist. (Von BaseDataBoundControl geerbt.)
	TabIndex	Ruft den Index der Aktivierreihenfolge des Webserversteuerelements festgelegt. (Von WebControl geerbt.)
	TagKey	Ruft den HtmlTextWriterTag-Wert für das ListControl-Steuerelement ab. (Überschreibt WebControl.TagKey.)
	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.)
	Text	Ruft die SelectedValue-Eigenschaft des ListControl-Steuerelements ab oder legt diese fest.
	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.)
	ValidationGroup	Ruft die Gruppe von Steuerelementen ab, für die das von der ListControl-Klasse abgeleitete Steuerelement eine Validierung auslöst, wenn es an den Server zurückgesendet wird, oder legt die entsprechende Gruppe fest.
	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	Wendet HTML-Attribute und -Formate für das Rendern im angegebenen HtmlTextWriter-Objekt an. (Überschreibt WebControl.AddAttributesToRender(HtmlTextWriter).)
	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.)
	ClearSelection	Löscht die Listenauswahl und legt die Selected-Eigenschaft aller Elemente auf false fest.
	ConfirmInitState	Legt den initialisierten Zustand des datengebundenen Steuerelements fest. (Von BaseDataBoundControl 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 das Stilobjekt, das von der WebControl-Klasse intern zum Implementieren aller auf Formatvorlagen bezogenen Eigenschaften. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	CreateDataSourceSelectArguments	Erstellt ein vom datengebundenen Steuerelement verwendetes DataSourceSelectArguments-Standardobjekt, wenn keine Argumente angegeben wurden. (Von DataBoundControl geerbt.)
	DataBind()	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und an seine untergeordneten Steuerelemente. (Von BaseDataBoundControl 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.)
	EnsureDataBound	Ruft die DataBind-Methode auf, wenn die DataSourceID-Eigenschaft festgelegt ist und das datengebundene Steuerelement so markiert ist, dass Bindung erforderlich. (Von BaseDataBoundControl 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.)
	GetData	Ruft ein DataSourceView-Objekt ab, mit dessen Hilfe das datengebundene Steuerelement Datenvorgänge ausführt. (Von DataBoundControl geerbt.)
	GetDataSource	Ruft die IDataSource-Schnittstelle ab, der das datengebundene Steuerelement zugeordnet ist (falls vorhanden). (Von DataBoundControl 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	Lädt den zuvor gespeicherten Ansichtszustand des DetailsView-Steuerelements. (Überschreibt DataBoundControl.LoadViewState(Object).)
	MapPathSecure	Ruft den physischen Pfad ab, mit dessen Hilfe ein virtueller Pfad absolut oder relativ, Zuordnungen zu. (Von Control geerbt.)
	MarkAsDataBound	Legt den Zustand des Steuerelements im Ansichtszustand als erfolgreich an Daten gebunden fest. (Von DataBoundControl 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 Serversteuerelement in der Hierarchie der das Benutzeroberfläche-Serversteuerelement der Seite nach oben weitergegeben wird. (Von Control geerbt.)
	OnCreatingModelDataSource	Löst das CreatingModelDataSource-Ereignis aus. (Von DataBoundControl geerbt.)
	OnDataBinding	Infrastruktur. Löst das DataBinding-Ereignis aus. (Überschreibt Control.OnDataBinding(EventArgs).)
	OnDataBound	Löst das DataBound-Ereignis aus. (Von BaseDataBoundControl geerbt.)
	OnDataPropertyChanged	Bindet das datengebundene Steuerelement nach einer Änderung der Eigenschaften zum Angeben der Basisdatenquelle erneut an die Daten. (Von DataBoundControl geerbt.)
	OnDataSourceViewChanged	Löst das DataSourceViewChanged-Ereignis aus. (Von DataBoundControl geerbt.)
	OnInit	Behandelt das Init-Ereignis. (Von BaseDataBoundControl geerbt.)
	OnLoad	Behandelt das Control.Load-Ereignis. (Von DataBoundControl geerbt.)
	OnPagePreLoad	Legt den initialisierten Zustand des datengebundenen Steuerelements fest, bevor das Steuerelement geladen wird. (Von DataBoundControl geerbt.)
	OnPreRender	Löst das PreRender-Ereignis aus. (Überschreibt BaseDataBoundControl.OnPreRender(EventArgs).)
	OnSelectedIndexChanged	Löst das SelectedIndexChanged-Ereignis aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
	OnTextChanged	Löst das TextChanged-Ereignis aus.
	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.)
	PerformDataBinding	Infrastruktur. Bindet die angegebene Datenquelle an das von der ListControl-Klasse abgeleitete Steuerelement. (Überschreibt DataBoundControl.PerformDataBinding(IEnumerable).)
	PerformSelect	Ruft die Daten aus der zugeordneten Datenquelle ab. (Überschreibt DataBoundControl.PerformSelect().)
	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	Gibt die Elemente im ListControl-Steuerelement wieder. (Überschreibt WebControl.RenderContents(HtmlTextWriter).)
	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.)
	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 den aktuellen Ansichtszustand des vom ListControl abgeleiteten Steuerelements und der darin enthaltenen Elemente. (Überschreibt DataBoundControl.SaveViewState().)
	SetDesignModeState	Legt Entwurfszeitdaten für ein Steuerelement fest. (Von Control geerbt.)
	SetPostDataSelection	Infrastruktur. Legt die Selected-Eigenschaft eines ListItem-Steuerelements fest, nachdem eine Seite gesendet wurde.
	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	Markiert den Anfangspunkt, an dem begonnen werden soll, Änderungen am Ansichtszustand eines von ListControl abgeleiteten Steuerelements nachzuverfolgen und zu speichern. (Überschreibt DataBoundControl.TrackViewState().)
	ValidateDataSource	Überprüft, ob es sich bei dem Objekt, an das ein datengebundenes Steuerelement gebunden wird, um ein Objekt handelt, mit dem es arbeiten kann. (Von DataBoundControl geerbt.)
	VerifyMultiSelect	Infrastruktur. Bestimmt, ob das Listensteuerelement den Modus zur Mehrfachauswahl unterstützt.

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	CallingDataMethods	Tritt auf, wenn Methoden aufgerufen werden. (Von DataBoundControl geerbt.)
	CreatingModelDataSource	Tritt ein, wenn das ModelDataSource-Objekt erstellt wird. (Von DataBoundControl geerbt.)
	DataBinding	Tritt ein, wenn das Serversteuerelement an eine Datenquelle gebunden wird. (Von Control geerbt.)
	DataBound	Tritt ein, wenn das Serversteuerelement an eine Datenquelle gebunden wird. (Von BaseDataBoundControl 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.)
	SelectedIndexChanged	Tritt ein, wenn die Auswahl im Listensteuerelement zwischen Übertragungen zum Server geändert wird.
	TextChanged	Tritt ein, wenn sich die Text-Eigenschaft und die SelectedValue-Eigenschaft ändern.
	Unload	Tritt ein, wenn das Serversteuerelement im Speicher entladen wird. (Von Control geerbt.)

Zum Seitenanfang

Erweiterungsmethoden

	Name	Beschreibung
	EnablePersistedSelection	Ermöglicht das Beibehalten der Auswahl in Datensteuerelementen, die Auswahl und Paginierung unterstützen. (Durch DynamicDataExtensions 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.)

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	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.)
	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.)

Zum Seitenanfang

Hinweise

Eine Instanz der abstrakten ListControl-Klasse kann nicht direkt erstellt werden. Um grundlegende gemeinsame Funktionen bereitzustellen, wird diese Klasse stattdessen von anderen Klassen geerbt, z. B. von den folgenden Klassen: CheckBoxList, DropDownList, ListBox und RadioButtonList.

Mithilfe der Eigenschaften der ListControl-Klasse können Sie die Quelle der Daten angeben, die zum Auffüllen des Listensteuerelements verwendet werden. Mit der DataSource-Eigenschaft wird die Datenquelle angegeben, die an das Listensteuerelement gebunden werden soll. Wenn die Datenquelle mehrere Tabellen enthält, können Sie die zu verwendende Tabelle mit der DataMember-Eigenschaft angeben. Durch Festlegen der DataTextField-Eigenschaft bzw. DataValueField-Eigenschaft können Sie verschiedene Felder der Datenquelle an die ListItem.Text-Eigenschaft und die ListItem.Value-Eigenschaft der Elemente im Listensteuerelement binden. Durch Festlegen der DataTextFormatString-Eigenschaft kann der im Listensteuerelement für jedes einzelne Element angezeigte Text formatiert werden.

Alle Elemente im Listensteuerelement sind in der Items-Auflistung gespeichert. Mit der SelectedIndex-Eigenschaft können Sie den Index eines im Listensteuerelement ausgewählten Elements programmgesteuert angeben oder bestimmen. Auf die Eigenschaften des ausgewählten Elements kann über die SelectedItem-Eigenschaft zugegriffen werden.

Die ListControl-Klasse stellt das SelectedIndexChanged-Ereignis bereit, das ausgelöst wird, wenn die Auswahl im Listensteuerelement zwischen Übertragungen an den Server geändert wird. Dadurch können Sie einen benutzerdefinierten Handler für dieses Ereignis bereitstellen. Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln von Ereignissen.

Die ListControl-Klasse implementiert die IEditableTextControl-Schnittstelle, sodass abgeleitete Steuerelemente vom Typ Liste im Vorlagenmodus anderer Steuerelemente verwendet werden können.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Elemente in einem ListBox-Steuerelement ausgewählt werden. Wenn das Element im Textfeld gefunden wird, wird es ausgewählt, und eine Meldung wird angezeigt, die den Namen des ausgewählten Elements angibt. Wenn kein Element gefunden wird, wird kein Element ausgewählt, und eine Meldung wird angezeigt, die angibt, dass das Element nicht gefunden wurde.

Sicherheitshinweis
In diesem Beispiel ist ein Textfeld für eine Benutzereingabe enthalten. Dies stellt ein potenzielles Sicherheitsrisiko dar. Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.



<%@ Page Language="C#" AutoEventWireup="True" %>

<!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" > 

<head runat="server">
    <title> ListControl SelectedValue Example </title>
<script runat="server">

      void Button_Click(Object sender, EventArgs e)
      {

         // Perform this operation in a try-catch block in case the item is not found.
         try
         {
            List.SelectedValue = ItemTextBox.Text;
            MessageLabel.Text = "You selected " + List.SelectedValue + ".";
         }
         catch (Exception ex)
         {
            List.SelectedValue = null;
            MessageLabel.Text = "Item not found in ListBox control.";
         }

      }

   </script>

</head>

<body>

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

      <h3> ListControl SelectedValue Example </h3>

      <asp:ListBox ID="List"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>

      </asp:ListBox>

      <hr />

      Enter the value of the item to select: <br />
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </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

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

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?

Informationen zur Datensicherheit