RepeaterItemEventHandler, délégué (System.Web.UI.WebControls)

RepeaterItemEventHandler, délégué

Réduire tout

Filtre de language

Affichage du contenu : côte à côte

.NET Framework Class Library

RepeaterItemEventHandler Delegate

Represents the method that will handle the ItemCreated and ItemDataBound events of a Repeater.

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

Syntax

Visual Basic

Public Delegate Sub RepeaterItemEventHandler ( _
    sender As Object, _
    e As RepeaterItemEventArgs _
)

public delegate void RepeaterItemEventHandler(
    Object sender,
    RepeaterItemEventArgs e
)

Visual C++

public delegate void RepeaterItemEventHandler(
    Object^ sender, 
    RepeaterItemEventArgs^ e
)

type RepeaterItemEventHandler = 
    delegate of 
        sender:Object * 
        e:RepeaterItemEventArgs -> unit

Parameters

sender: Type: System..::.Object
The source of the event.

e: Type: System.Web.UI.WebControls..::.RepeaterItemEventArgs
A RepeaterItemEventArgs that contains the event data.

Remarks

When you create a RepeaterItemEventHandler delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event handler delegates, see Events and Delegates.

For more information about handling events, see Consuming Events.

Examples

The following example demonstrates how to specify and code a handler for the ItemCreated event of the Repeater. A new line of text indicating the item type is displayed whenever a Repeater item is created.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

<html  >
<head>
    <title>Repeater Example</title>
</head>
<body>
    <form id="form1" runat="server">

    <h3>Repeater Example</h3>

       <p style="font-weight: bold">Repeater1:</p>

       <asp:Repeater ID="Repeater1" OnItemCreated="R1_ItemCreated" runat="server">
          <HeaderTemplate>
             <table border="1">
                <tr>
                   <td style="font-weight:bold">Company</td>
                   <td style="font-weight:bold">Symbol</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>
       <br />

       <asp:Label ID="Label1" Font-Names="Verdana" 
          ForeColor="Green" Font-Size="10pt" Runat="server"/>
    </form>
 </body>
 </html>

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

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

<html  >
<head>
    <title>Repeater Example</title>
</head>
<body>
    <form id="form1" runat="server">

    <h3>Repeater Example</h3>

       <p style="font-weight: bold">Repeater1:</p>

       <asp:Repeater ID="Repeater1" OnItemCreated="R1_ItemCreated" runat="server">
          <HeaderTemplate>
             <table border="1">
                <tr>
                   <td style="font-weight:bold">Company</td>
                   <td style="font-weight:bold">Symbol</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>
       <br />

       <asp:Label ID="Label1" Font-Names="Verdana" 
          ForeColor="Green" Font-Size="10pt" Runat="server"/>
    </form>
 </body>
 </html>

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

System.Web.UI.WebControls Namespace

Repeater

RepeaterItemEventArgs

ItemCreated

ItemDataBound

Other Resources

Repeater Web Server Control

Bibliothèque de classes .NET Framework

RepeaterItemEventHandler, délégué

Représente la méthode qui gérera les événements ItemCreated et ItemDataBound de Repeater.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans System.Web.dll)

Syntaxe

Visual Basic

Public Delegate Sub RepeaterItemEventHandler ( _
    sender As Object, _
    e As RepeaterItemEventArgs _
)

public delegate void RepeaterItemEventHandler(
    Object sender,
    RepeaterItemEventArgs e
)

VisualC++

public delegate void RepeaterItemEventHandler(
    Object^ sender, 
    RepeaterItemEventArgs^ e
)

type RepeaterItemEventHandler = 
    delegate of 
        sender:Object * 
        e:RepeaterItemEventArgs -> unit

Paramètres

sender: Type : System..::.Object
Source de l'événement.

e: Type : System.Web.UI.WebControls..::.RepeaterItemEventArgs
RepeaterItemEventArgs qui contient les données d'événement.

Notes

Lorsque vous créez un délégué RepeaterItemEventHandler, vous identifiez la méthode qui gérera l'événement. Pour associer l'événement à votre gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois que l'événement se produit, sauf si vous supprimez le délégué. Pour plus d'informations sur les délégués de gestionnaires d'événements, consultez Événements et délégués.

Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

Exemples

L'exemple suivant montre comment spécifier et coder un gestionnaire pour l'événement ItemCreated du contrôle Repeater. Une nouvelle ligne de texte indiquant le type d'élément s'affiche à chaque création d'un élément Repeater.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

<html  >
<head>
    <title>Repeater Example</title>
</head>
<body>
    <form id="form1" runat="server">

    <h3>Repeater Example</h3>

       <p style="font-weight: bold">Repeater1:</p>

       <asp:Repeater ID="Repeater1" OnItemCreated="R1_ItemCreated" runat="server">
          <HeaderTemplate>
             <table border="1">
                <tr>
                   <td style="font-weight:bold">Company</td>
                   <td style="font-weight:bold">Symbol</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>
       <br />

       <asp:Label ID="Label1" Font-Names="Verdana" 
          ForeColor="Green" Font-Size="10pt" Runat="server"/>
    </form>
 </body>
 </html>

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

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

<html  >
<head>
    <title>Repeater Example</title>
</head>
<body>
    <form id="form1" runat="server">

    <h3>Repeater Example</h3>

       <p style="font-weight: bold">Repeater1:</p>

       <asp:Repeater ID="Repeater1" OnItemCreated="R1_ItemCreated" runat="server">
          <HeaderTemplate>
             <table border="1">
                <tr>
                   <td style="font-weight:bold">Company</td>
                   <td style="font-weight:bold">Symbol</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>
       <br />

       <asp:Label ID="Label1" Font-Names="Verdana" 
          ForeColor="Green" Font-Size="10pt" Runat="server"/>
    </form>
 </body>
 </html>

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Voir aussi

Référence

System.Web.UI.WebControls, espace de noms

Repeater

RepeaterItemEventArgs

ItemCreated

ItemDataBound

Autres ressources

Repeater Web Server Control

Mots clés

: Ajouter un mot clé

Contenu de la communauté

Ajouter du contenu

Annotations

Gérer votre profil | Contactez-nous | Newsletter MSDN