ListControl-Klasse
Fungiert als die abstrakte Basisklasse, in der die Eigenschaften, Methoden und Ereignisse definiert sind, die allen Steuerelementen vom Typ Liste gemeinsam sind.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ControlValuePropertyAttribute("SelectedValue")> _
Public MustInherit Class ListControl
Inherits DataBoundControl
Implements IEditableTextControl, ITextControl
'Usage
Dim instance As ListControl
[ControlValuePropertyAttribute("SelectedValue")]
public abstract class ListControl : DataBoundControl, IEditableTextControl, ITextControl
[ControlValuePropertyAttribute(L"SelectedValue")]
public ref class ListControl abstract : public DataBoundControl, IEditableTextControl, ITextControl
/** @attribute ControlValuePropertyAttribute("SelectedValue") */
public abstract class ListControl extends DataBoundControl implements IEditableTextControl, ITextControl
ControlValuePropertyAttribute("SelectedValue")
public abstract class ListControl extends DataBoundControl implements IEditableTextControl, ITextControl
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.
Beispiel
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.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub Button_Click(sender As Object, e As EventArgs)
' 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 ex As Exception
List.SelectedValue = Nothing
MessageLabel.Text = "Item not found in ListBox control."
End Try
End Sub
</script>
</head>
<body>
<form 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"/>
<asp:Button ID="SelectButton"
Text="Select Item"
OnClick="Button_Click"
runat="server"/>
<br><br>
<asp:Label ID="MessageLabel"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<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 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"/>
<asp:Button ID="SelectButton"
Text="Select Item"
OnClick="Button_Click"
runat="server"/>
<br><br>
<asp:Label ID="MessageLabel"
runat="server"/>
</form>
</body>
</html>
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
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
ListControl-Member
System.Web.UI.WebControls-Namespace
CheckBoxList-Klasse
DropDownList-Klasse
ListBox-Klasse
RadioButtonList
ListItem