Repeater.CreateItem-Methode

Artikel
08/20/2007

Diese Methode unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code bestimmt.

Erstellt ein RepeaterItem-Objekt mit dem angegebenen Elementtyp und der angegebenen Position im Repeater-Steuerelement.

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

Syntax

'Declaration
Protected Overridable Function CreateItem ( _
    itemIndex As Integer, _
    itemType As ListItemType _
) As RepeaterItem
'Usage
Dim itemIndex As Integer
Dim itemType As ListItemType
Dim returnValue As RepeaterItem

returnValue = Me.CreateItem(itemIndex, itemType)

protected virtual RepeaterItem CreateItem (
    int itemIndex,
    ListItemType itemType
)

protected:
virtual RepeaterItem^ CreateItem (
    int itemIndex, 
    ListItemType itemType
)

protected RepeaterItem CreateItem (
    int itemIndex, 
    ListItemType itemType
)

protected function CreateItem (
    itemIndex : int, 
    itemType : ListItemType
) : RepeaterItem

Parameter

itemIndex
Die angegebene Position im Repeater-Steuerelement, an der das erstellte Element platziert werden soll.

itemType
Ein ListItemType, der den angegebenen Typ des zu erstellenden Repeater-Elements darstellt.

Rückgabewert

Das neue RepeaterItem-Objekt.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die CreateItem-Methode in einem benutzerdefinierten Serversteuerelement überschrieben wird, sodass immer ein neues RepeaterItem sowie der entsprechende Index und Typ in einem benutzerdefinierten Repeater-Serversteuerelement zurückgegeben werden.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom Repeater - CreateItem - VB.NET Example</title>
        <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

            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>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Repeater - CreateItem - VB.NET Example</h3>
            
            <aspSample:CustomRepeaterCreateItem id="Repeater1" runat="server" >
                    <HeaderTemplate>
                        <table border="1" cellpadding="4" cellspacing="0">
                            <tr>
                                <th>Company</th>
                                <th>Symbol</th>
                            </tr>
                    </HeaderTemplate>
                    <ItemTemplate>
                        <tr>
                            <td> <%# DataBinder.Eval(Container.DataItem, "Name") %></td>
                            <td> <%# DataBinder.Eval(Container.DataItem, "Ticker") %></td>
                        </tr>
                    </ItemTemplate>
                    <FooterTemplate>
                        </table>

                    </FooterTemplate>
                </aspSample:CustomRepeaterCreateItem>
        </form>
    </body>
</HTML>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom Repeater - CreateItem - C# Example</title>
    <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();
        }
      }

      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>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Repeater - CreateItem - C# Example</h3>
            
            <aspSample:CustomRepeaterCreateItem id="Repeater1" runat="server">
          <HeaderTemplate>
            <table border="1" cellpadding="4" cellspacing="0">
              <tr>
                <th>Company</th>
                <th>Symbol</th>
              </tr>
          </HeaderTemplate>
          <ItemTemplate>
            <tr>
              <td> <%# DataBinder.Eval(Container.DataItem, "Name") %></td>
              <td> <%# DataBinder.Eval(Container.DataItem, "Ticker") %></td>
            </tr>
          </ItemTemplate>
          <FooterTemplate>
            </table>

          </FooterTemplate>
      </aspSample:CustomRepeaterCreateItem>
        </form>
    </body>
</HTML>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom Repeater - CreateItem - VJ# Example</title>
    <script language="VJ#" runat="server">
        void Page_Load(Object Sender, EventArgs e) 
        {
            if (!get_IsPostBack()) {
                ArrayList values = new ArrayList();
                values.Add(new PositionData("Microsoft", "Msft"));
                values.Add(new PositionData("Intel", "Intc"));
                values.Add(new PositionData("Dell", "Dell"));
                Repeater1.set_DataSource(values);
                Repeater1.DataBind();
            }
        } //Page_Load

        public class PositionData 
        {
            private String name;
            private String ticker;

            public PositionData(String name, String ticker) 
            {
                this.name = name;
                this.ticker = ticker;
            } //PositionData

            /** @property 
             */
            public String get_Name()
            {
                return name;
            } //get_Name

            /** @property 
             */
            public String get_Ticker()
            {
                return ticker;
            } //get_Ticker
        } //PositionData 
    </script>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Repeater - CreateItem - VJ# Example</h3>
            
            <aspSample:CustomRepeaterCreateItem id="Repeater1" runat="server">
          <HeaderTemplate>
            <table border="1" cellpadding="4" cellspacing="0">
              <tr>
                <th>Company</th>
                <th>Symbol</th>
              </tr>
          </HeaderTemplate>
          <ItemTemplate>
            <tr>
              <td> <%# DataBinder.Eval(Container.get_DataItem(), "Name") %></td>
              <td> <%# DataBinder.Eval(Container.get_DataItem(), "Ticker") %></td>
            </tr>
          </ItemTemplate>
          <FooterTemplate>
            </table>

          </FooterTemplate>
      </aspSample:CustomRepeaterCreateItem>
        </form>
    </body>
</HTML>

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomRepeaterCreateItem
        Inherits System.Web.UI.WebControls.Repeater

        Protected Overrides Function CreateItem(ByVal itemIndex As Integer, ByVal itemType As System.Web.UI.WebControls.ListItemType) As System.Web.UI.WebControls.RepeaterItem

            ' Return a new RepeaterItem with the corresponding item index and type.
            Return New System.Web.UI.WebControls.RepeaterItem(itemIndex, itemType)
        End Function
    End Class
End Namespace

using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomRepeaterCreateItem : System.Web.UI.WebControls.Repeater
  {
    protected override System.Web.UI.WebControls.RepeaterItem CreateItem(int itemIndex, System.Web.UI.WebControls.ListItemType itemType)
    {
      // Return a new RepeaterItem with the corresponding item index and type.
      return new System.Web.UI.WebControls.RepeaterItem(itemIndex, itemType);
    }
  }
}

package Samples.AspNet.JSL.Controls; 

public class CustomRepeaterCreateItem
    extends System.Web.UI.WebControls.Repeater
{
    protected System.Web.UI.WebControls.RepeaterItem CreateItem(int itemIndex,
        System.Web.UI.WebControls.ListItemType itemType)
    {
        // Return a new RepeaterItem with the corresponding item index and type.
        return new System.Web.UI.WebControls.RepeaterItem(itemIndex, itemType);
    } //CreateItem
} //CustomRepeaterCreateItem

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.

Freigeben über

Repeater.CreateItem-Methode

Syntax

Parameter

Rückgabewert

Beispiel

Plattformen

Versionsinformationen

.NET Framework

Siehe auch

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen