ListItem.Selected-Eigenschaft
Ruft einen Wert ab, der angibt, ob das Element ausgewählt ist, oder legt diesen fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Property Selected As Boolean
'Usage
Dim instance As ListItem
Dim value As Boolean
value = instance.Selected
instance.Selected = value
public bool Selected { get; set; }
public:
property bool Selected {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_Selected ()
/** @property */
public void set_Selected (boolean value)
public function get Selected () : boolean
public function set Selected (value : boolean)
Eigenschaftenwert
true, wenn das Element ausgewählt ist, andernfalls false. Der Standardwert ist false.
Hinweise
Mit der Selected-Eigenschaft können Sie bestimmen, ob das ListItem gegenwärtig in dem Listensteuerelement ausgewählt ist, in dem es enthalten ist. Diese Eigenschaft wird häufig beim Durchlaufen einer Auflistung von ListItem-Objekten in einem Listensteuerelement verwendet, um zu bestimmen, ob ein Element ausgewählt ist.
| Thema | Position |
|---|---|
| Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio) | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio) | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio) | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Beispiel wird die Verwendung der Selected-Eigenschaft beim Durchlaufen der Items-Auflistung eines CheckBoxList-Steuerelements veranschaulicht, um zu bestimmen, welche Kontrollkästchen aktiviert sind.
Hinweis
Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-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="VB" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<script language="VB" runat="server">
Sub Check_Clicked(sender As Object, e As EventArgs)
Message.Text = "Selected Item(s):<br><br>"
Dim i As Integer
For i = 0 To checkboxlist1.Items.Count - 1
If checkboxlist1.Items(i).Selected Then
Message.Text = Message.Text & checkboxlist1.Items(i).Text & "<br>"
End If
Next
End Sub
</script>
<form action="checkboxlist.aspx" method="post" runat="server">
<asp:CheckBoxList id="checkboxlist1" runat="server"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Flow"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked">
<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:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br><br>
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<script language="C#" runat="server">
void Check_Clicked(Object sender, EventArgs e) {
Message.Text="Selected Item(s):" + "<br>" + "<br>";
for (int i=0; i<checkboxlist1.Items.Count; i++) {
if (checkboxlist1.Items[i].Selected)
Message.Text=Message.Text + checkboxlist1.Items[i].Text + "<br>";
}
}
</script>
<form action="checkboxlist.aspx" method="post" runat="server">
<asp:CheckBoxList id="checkboxlist1" runat="server"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Flow"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked">
<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:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br><br>
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<script language="JSCRIPT" runat="server">
function Check_Clicked(sender : Object, e : EventArgs){
Message.Text = "Selected Item(s):<br><br>"
for(var i = 0; i < checkboxlist1.Items.Count; i++){
if(checkboxlist1.Items(i).Selected)
Message.Text = Message.Text + checkboxlist1.Items(i).Text + "<br>"
}
}
</script>
<form action="checkboxlist.aspx" method="post" runat="server">
<asp:CheckBoxList id="checkboxlist1" runat="server"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Flow"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked">
<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:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br><br>
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
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
ListItem-Klasse
ListItem-Member
System.Web.UI.WebControls-Namespace
ListControl.Items-Eigenschaft
CheckBoxList-Klasse
ListControl-Klasse
RadioButtonList
ListBox-Klasse
DropDownList-Klasse
CheckBoxList-Klasse
Weitere Ressourcen
ListBox-Webserver-Steuerelement
Übersicht über die RadioButton- und RadioButtonList-Webserversteuerelemente
CheckBox- und CheckBoxList-Webserver-Steuerelemente
BulletedList-Webserver-Steuerelement
DropDownList-Webserversteuerelement