Freigeben über


RepeaterItemEventArgs-Klasse

Stellt Daten für das ItemCreated-Ereignis und das ItemDataBound-Ereignis von Repeater bereit.

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

Syntax

'Declaration
Public Class RepeaterItemEventArgs
    Inherits EventArgs
'Usage
Dim instance As RepeaterItemEventArgs
public class RepeaterItemEventArgs : EventArgs
public ref class RepeaterItemEventArgs : public EventArgs
public class RepeaterItemEventArgs extends EventArgs
public class RepeaterItemEventArgs extends EventArgs

Hinweise

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von RepeaterItemEventArgs finden Sie unter RepeaterItemEventArgs-Konstruktor.

Weitere Informationen über die Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie für das ItemCreated-Ereignis von Repeater einen Handler angeben und codieren können. Eine neue Textzeile, die angibt, dass bei jedem Erstellen eines Repeater-Elements der Elementtyp angezeigt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <head>
    <script language="VB" runat="server">
    Dim Count As Integer = 1

    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_ItemCreated(Sender As Object, e As RepeaterItemEventArgs)
        Dim iTypeText As String = ""
        
        Select Case e.Item.ItemType
            Case ListItemType.Item
                iTypeText = "Item"
            Case ListItemType.AlternatingItem
                iTypeText = "AlternatingItem"
            Case ListItemType.Header
                iTypeText = "Header"
            Case ListItemType.Footer
                iTypeText = "Footer"
            Case ListItemType.Separator
                iTypeText = "Separator"
        End Select
        Count = Count + 1
        Label1.Text &= "(" & Count & ") A Repeater " & iTypeText & _
            " has been created; <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 OnItemCreated="R1_ItemCreated" 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> <%# DataBinder.Eval(Container.DataItem, "Ticker") %> </td>
             </tr>
          </ItemTemplate>
             
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
       <asp:Label id=Label1 font-name="Verdana" ForeColor="Red" font-size="10pt" runat="server"/>
    </form>
 </body>
 </html>
    
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
    <script language="C#" runat="server">
       int Count = 1;
       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_ItemCreated(Object Sender, RepeaterItemEventArgs e) {
          String iTypeText = "";
 
          switch (e.Item.ItemType) {
             case ListItemType.Item:
                iTypeText = "Item";
                break;
             case ListItemType.AlternatingItem:
                iTypeText = "AlternatingItem";
                break;
             case ListItemType.Header:
                iTypeText = "Header";
                break;
             case ListItemType.Footer:
                iTypeText = "Footer";
                break;
             case ListItemType.Separator:
                iTypeText = "Separator";
                break;
          }
          Label1.Text += "(" + Count++ + ") A Repeater " + iTypeText + " has been created; <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 OnItemCreated="R1_ItemCreated" 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> <%# DataBinder.Eval(Container.DataItem, "Ticker") %> </td>
             </tr>
          </ItemTemplate>
             
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
       <asp:Label id=Label1 font-name="Verdana" ForeColor="Red" font-size="10pt" runat="server"/>
    </form>
 </body>
 </html>
    

Vererbungshierarchie

System.Object
   System.EventArgs
    System.Web.UI.WebControls.RepeaterItemEventArgs

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

RepeaterItemEventArgs-Member
System.Web.UI.WebControls-Namespace
Repeater-Klasse
RepeaterItemEventHandler
Repeater.ItemCreated-Ereignis
Repeater.ItemDataBound-Ereignis