Freigeben über

Übersicht über das BulletedList-Webserversteuerelement

  • Artikel

Aktualisiert: November 2007

Mit dem BulletedList-Steuerelement wird eine ungeordnete oder eine geordnete (nummerierte) Liste von Elementen erstellt. Diese Elemente werden in HTML jeweils als ul-Element bzw. als ol-Element dargestellt.

Dieses Thema enthält folgende Abschnitte:

  • Szenarien

  • Features

  • Hintergrund

  • Gewusst-wie-Themen und Themen mit exemplarischen Vorgehensweisen

  • Klassenreferenz

Szenarien

Mit dem BulletedList-Steuerelement können Sie folgende Aufgaben ausführen:

  • Angeben der Darstellung von Elementen und Aufzählungszeichen bzw. Zahlen in einer Liste

  • Statisches Definieren von Listenelementen oder Definition durch das Binden des Steuerelements an Daten

  • Reagieren auf Klicks des Benutzers auf Elemente

Zurück nach oben

Features

Mit dem BulletedList-Steuerelement können Sie folgende Aufgaben ausführen:

  • Anpassen der Darstellung von Aufzählungszeichen und Zahlen

  • Angeben der Darstellungsart der einzelnen Elemente in der Liste (z. B. als Hyperlink, als statischer Text oder als Verknüpfungsschaltfläche)

  • Bereitstellen von Logik zum Ausführen anwendungsspezifischer Aufgaben, wenn ein Benutzer auf ein Element klickt

Zurück nach oben

Hintergrund

Das BulletedList-Steuerelement wird von derselben ListControl-Klasse abgeleitet wie ListBox, DropDownList und andere ASP.NET-Listensteuerelemente. Daher kann das BulletedList-Steuerelement ähnlich wie diese Steuerelemente verwendet werden. Sie können Listenelemente für das BulletedList-Steuerelement definieren, indem Sie statische Elemente erstellen oder indem Sie das Steuerelement an eine Datenquelle binden. Wenn Sie bereits zur Entwurfszeit wissen, welche Elemente angezeigt werden sollen, können Sie die Items-Auflistung des Steuerelements im Markup auf einen Satz einzelner Elemente festlegen. Wenn dynamische Elemente angezeigt werden sollen, können Sie die Elementauflistung zur Laufzeit im Code erstellen. Ausführliche Informationen finden Sie unter Gewusst wie: Hinzufügen von Elementen zu List-Webserversteuerelementen (Visual Studio).

Wahlweise können Sie das Steuerelement auch an eine Datenquelle binden, in der die anzuzeigenden Informationen enthalten sind. Ausführliche Informationen finden Sie unter Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio).

Sie können statische und datenquellengebundene Listenelemente kombinieren, indem Sie die AppendDataBoundItems-Eigenschaft des Steuerelementes auf true festlegen.

Bei der Definition der Elemente für das BulletedList-Steuerelement definieren Sie zwei Eigenschaften: die Text-Eigenschaft und die Value-Eigenschaft. Die Text-Eigenschaft definiert, was das Steuerelement auf der Seite anzeigt. Die Value-Eigenschaft definiert einen zweiten Wert, der nicht angezeigt wird, den Sie jedoch bei der Auswahl eines Elements durch den Benutzer zurückgeben lassen können. Sie können beispielsweise den Namen eines Mitarbeiters als Text in einem Element anzeigen, jedoch als Wert die Mitarbeiter-ID verwenden. Wenn Benutzer auf das Element klicken, kann der Wert direkt gelesen werden.

Sicherheitshinweis:

Verwenden Sie keine vertraulichen Daten wie etwa Kundennummern für die Werteigenschaft des BulletedList-Steuerelements. Die Werte der Value-Eigenschaft von einzelnen Elementen sind zwar nicht direkt sichtbar, können von den Benutzern aber im Quellcode gelesen werden.

Anpassen der Darstellung von Listenelementen

Das BulletedList-Steuerelement kann sowohl Aufzählungszeichen als auch Nummern darstellen. Die Darstellung hängt vom Wert der BulletStyle-Eigenschaft ab. Wenn das Steuerelement auf die Darstellung von Aufzählungszeichen festgelegt ist, können Sie unter verschiedenen vordefinierten Aufzählungszeichenformaten wählen, die den standardmäßigen HTML-Formaten für Aufzählungszeichen entsprechen. Diese Formate werden z. B. durch das Disc-Feld, das Circle-Feld und das Square Feld dargestellt.

Hinweis:

Die Darstellung der Aufzählungszeichen kann sich je nach Browser unterscheiden, und manche Browser unterstützen bestimmte Aufzählungszeichenformate (z. B. das Disc-Feld) nicht.

Sie können auch ein benutzerdefiniertes Bild als Aufzählungszeichen angeben.

Wenn das Steuerelement auf die Darstellung von Nummern festgelegt ist, stehen Ihnen die standardmäßigen HTML-Nummerierungsoptionen zur Verfügung, wie z. B. die Felder LowerAlpha, UpperAlpha, LowerRoman oder UpperAlpha. Sie können außerdem eine Startzahl für die Aufzählungssequenz angeben, indem Sie die FirstBulletNumber-Eigenschaft festlegen.

Angeben des Elementanzeigemodus

Das BulletedList-Steuerelement kann Listenelemente wie folgt darstellen:

  • Statischer Text   Der vom Steuerelement anzeigte Text ist nicht interaktiv.

  • T:System.Web.UI.WebControls.HyperLink-Steuerelemente   Benutzer können auf Links klicken, um zu einer anderen Seite zu wechseln. Sie müssen für die einzelnen Elemente als Value-Eigenschaft einen Ziel-URL angeben.

  • LinkButton-Steuerelemente   Benutzer können auf einzelne Elemente klicken, woraufhin das Steuerelement dann ein Postback ausführt.

Reagieren auf die Auswahl des Benutzers

Wenn das BulletedList-Steuerelement die einzelnen Elemente als LinkButton-Steuerelemente darstellt, dann löst das Klicken eines Benutzers auf eines dieser Steuerelemente ein Postback aus. Der Postback löst das Click-Ereignis des BulletedList-Steuerelements aus, und auf dieses Ereignis können Sie mit Code zur Ausführung anwendungsspezifischer Aufgaben reagieren. Das Ereignis übergibt die Indexnummer des Elements, auf das geklickt wurde. Ausführliche Informationen finden Sie unter Gewusst wie: Reagieren auf Mausklicks in BulletedList-Webserversteuerelementen (Visual Studio).

Gewusst-wie-Themen und Themen mit exemplarischen Vorgehensweisen

Klassenreferenz

In der folgenden Tabelle sind die Klassen aufgelistet, die sich auf das BulletedList-Steuerelement beziehen.

Member

Beschreibung

BulletedList

Die Hauptklasse des Steuerelements.

BulletedListDisplayMode

Eine Enumeration, die das Anzeigeverhalten der einzelnen Elemente angibt.

BulletedListEventArgs

Die Ereignisdaten, die den Index des ausgewählten Elements angeben.

BulletedListEventHandler

Die Methode, die das Click-Ereignis eines BulletedList-Steuerelements behandelt.

BulletStyle

Eine Enumeration, die die Typen von Aufzählungszeichen, Zahlen oder Buchstaben angibt, die angezeigt werden können.

Zurück nach oben

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen von Elementen zu List-Webserversteuerelementen (Visual Studio)

Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio)

Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio)