Freigeben über


Repeater.Items-Eigenschaft

Ruft eine Auflistung von RepeaterItem-Objekten im Repeater-Steuerelement ab.

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

Syntax

'Declaration
Public Overridable ReadOnly Property Items As RepeaterItemCollection
'Usage
Dim instance As Repeater
Dim value As RepeaterItemCollection

value = instance.Items
public virtual RepeaterItemCollection Items { get; }
public:
virtual property RepeaterItemCollection^ Items {
    RepeaterItemCollection^ get ();
}
/** @property */
public RepeaterItemCollection get_Items ()
public function get Items () : RepeaterItemCollection

Eigenschaftenwert

Eine Auflistung von RepeaterItem-Objekten. Standardmäßig ist die RepeaterItemCollection leer.

Hinweise

Durch das Repeater-Steuerelement wird die Items-Auflistung aufgefüllt, indem jedes Objekt in der zugehörigen DataSource aufgezählt wird. Die Items-Auflistung wird dann vom Repeater-Steuerelement zum Wiedergeben der einzelnen Elemente im Steuerelement verwendet.

Beispiel

Das folgende Beispiel veranschaulicht, wie mit der Items-Eigenschaft der Index des im Repeater-Steuerelement ausgewählten Elements bestimmt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <head>
    <script language="VB" runat="server">

    Sub Page_Load(Sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            Dim values As New ArrayList()
            
            values.Add(New PositionData("Microsoft", "Msft"))
            values.Add(New PositionData("Intel", "Intc"))
            values.Add(New PositionData("Dell", "Dell"))
            
            Repeater1.DataSource = values
            Repeater1.DataBind()
        End If
    End Sub

    Sub R1_ItemCommand(Sender As Object, e As RepeaterCommandEventArgs)
        Label2.Text = "Button " & _
            Repeater1.Items(e.Item.ItemIndex).ItemIndex.ToString() & _
            " has just been clicked! <br>"
    End Sub
 
    Public Class PositionData
        
        Private myName As String
        Private myTicker As String        
        
        Public Sub New(newName As String, newTicker As String)
            Me.myName = newName
            Me.myTicker = newTicker
        End Sub        
        
        Public ReadOnly Property Name() As String
            Get
                Return myName
            End Get
        End Property        
        
        Public ReadOnly Property Ticker() As String
            Get
                Return myTicker
            End Get
        End Property
    End Class

 
    </script>
 
 </head>
 <body>
 
    <h3>Repeater Example</h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
         
       <p>
         
       <asp:Repeater id=Repeater1 
                     OnItemCommand="R1_ItemCommand" 
                     runat="server">
          <HeaderTemplate>
             <table border=1>
                <tr>
                   <td><b>Company</b></td>
                   <td><b>Symbol</b></td>
                </tr>
          </HeaderTemplate>
             
          <ItemTemplate>
             <tr>
                <td> <%# DataBinder.Eval(Container.DataItem, "Name") %> </td>
                <td> <asp:Button Text=<%# DataBinder.Eval(Container.DataItem, "Ticker") %> 
                          runat="server" /></td>
             </tr>
          </ItemTemplate>
             
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
       <asp:Label id=Label2 
                  font-name="Verdana" 
                  ForeColor="Green" 
                  font-size="10pt" 
                  runat="server"/>
    </form>
 </body>
 </html>
 
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
    <script language="C#" runat="server">
       void Page_Load(Object Sender, EventArgs e) {
 
          if (!IsPostBack) {
             ArrayList values = new ArrayList();
 
             values.Add(new PositionData("Microsoft", "Msft"));
             values.Add(new PositionData("Intel", "Intc"));
             values.Add(new PositionData("Dell", "Dell"));
 
             Repeater1.DataSource = values;
             Repeater1.DataBind();
          }
       }
 
       void R1_ItemCommand(Object Sender, RepeaterCommandEventArgs e) {        
          Label2.Text = "Button " + Repeater1.Items[e.Item.ItemIndex].ItemIndex.ToString() + 
                        " has just been clicked! <br>";
       }    
 
       public class PositionData {
         
          private string name;
          private string ticker;
 
          public PositionData(string name, string ticker) {
             this.name = name;
             this.ticker = ticker;
          }
 
          public string Name {
             get {
                return name;
             }
          }
 
          public string Ticker {
             get {
                return ticker;
             }
          }
       }
 
    </script>
 
 </head>
 <body>
 
    <h3>Repeater Example</h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
         
       <p>
         
       <asp:Repeater id=Repeater1 
                     OnItemCommand="R1_ItemCommand" 
                     runat="server">
          <HeaderTemplate>
             <table border=1>
                <tr>
                   <td><b>Company</b></td>
                   <td><b>Symbol</b></td>
                </tr>
          </HeaderTemplate>
             
          <ItemTemplate>
             <tr>
                <td> <%# DataBinder.Eval(Container.DataItem, "Name") %> </td>
                <td> <asp:Button Text=<%# DataBinder.Eval(Container.DataItem, "Ticker") %> 
                          runat="server" /></td>
             </tr>
          </ItemTemplate>
             
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
       <asp:Label id=Label2 
                  font-name="Verdana" 
                  ForeColor="Green" 
                  font-size="10pt" 
                  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

Repeater-Klasse
Repeater-Member
System.Web.UI.WebControls-Namespace
RepeaterItemCollection

Weitere Ressourcen

Repeater-Webserver-Steuerelement