ListItem.Selected Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob das Element ausgewählt ist, oder legt diesen fest.
public:
property bool Selected { bool get(); void set(bool value); };
public bool Selected { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.MinimizableAttributeTypeConverter))]
public bool Selected { get; set; }
member this.Selected : bool with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.MinimizableAttributeTypeConverter))>]
member this.Selected : bool with get, set
Public Property Selected As Boolean
Eigenschaftswert
true
, wenn das Element ausgewählt ist, andernfalls false
. Der Standardwert ist false
.
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Die Selected -Eigenschaft beim Durchlaufen der Items Auflistung eines CheckBoxList Steuerelements verwendet wird, um zu bestimmen, welche Kontrollkästchen aktiviert sind.
Hinweis
Das folgende Codebeispiel verwendet das Einzeldateicodemodell und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung ASPX kopiert werden. Weitere Informationen zum Web Forms Codemodell finden Sie unter ASP.NET Web Forms Seitencodemodell.
<%@ 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>
<title>ASP.NET Example</title>
</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 id="form1" 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="VB" 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>
<title>ASP.NET Example</title>
</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 id="form1" 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>
Hinweise
Verwenden Sie die Selected -Eigenschaft, um zu bestimmen, ob das ListItem derzeit im Listensteuerelement ausgewählt ist, das es enthält. Diese Eigenschaft wird häufig verwendet, wenn eine Auflistung von ListItem Objekten in einem Listensteuerelement durchlaufen wird, um zu bestimmen, ob ein Element ausgewählt ist.
Gilt für:
Weitere Informationen
- Items
- CheckBoxList
- ListControl
- RadioButtonList
- ListBox
- DropDownList
- Übersicht über das ListBox-Webserversteuerelement
- Übersicht über radioButton- und RadioButtonList-Webserversteuerelemente
- Übersicht über CheckBox- und CheckBoxList-Webserversteuerelemente
- Übersicht über das BulletedList-Webserversteuerelement
- Übersicht über das DropDownList-Webserversteuerelement
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für