ListControl.Items-Eigenschaft

Artikel
08/20/2007

Ruft die Auflistung der Elemente im Listensteuerelement ab.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable ReadOnly Property Items As ListItemCollection
'Usage
Dim instance As ListControl
Dim value As ListItemCollection

value = instance.Items

public virtual ListItemCollection Items { get; }

public:
virtual property ListItemCollection^ Items {
    ListItemCollection^ get ();
}

/** @property */
public ListItemCollection get_Items ()

public function get Items () : ListItemCollection

Eigenschaftenwert

Eine ListItemCollection zur Darstellung der Elemente in der Liste. Der Standardwert ist eine leere Liste.

Hinweise

Mit dieser Eigenschaft können Sie die Eigenschaften der Elemente im Listensteuerelement abrufen. Mit dieser Eigenschaft können Sie die Elemente bestimmen, die im Listensteuerelement ausgewählt sind.

Thema	Position
Gewusst wie: Festlegen von Eigenschaften für Webserversteuerelemente in Auflistungen	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen von Eigenschaften für Webserversteuerelemente in Auflistungen	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen von Eigenschaften für Webserversteuerelemente in Auflistungen	Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie mit der Items-Eigenschaft die in einem CheckBoxList-Steuerelement ausgewählten Elemente bestimmt werden.

<%@ 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 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 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 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

ListControl-Klasse
ListControl-Member
System.Web.UI.WebControls-Namespace
ListItemCollection

Freigeben über