ListItem.Selected-Eigenschaft

Artikel
08/20/2007

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

Freigeben über