Freigeben über


Repeater.AlternatingItemTemplate-Eigenschaft

Ruft das die System.Web.UI.ITemplate implementierende Objekt ab, das definiert, wie abwechselnde Elemente im Steuerelement dargestellt werden, oder legt dieses fest.

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

Syntax

'Declaration
<TemplateContainerAttribute(GetType(RepeaterItem))> _
Public Overridable Property AlternatingItemTemplate As ITemplate
'Usage
Dim instance As Repeater
Dim value As ITemplate

value = instance.AlternatingItemTemplate

instance.AlternatingItemTemplate = value
[TemplateContainerAttribute(typeof(RepeaterItem))] 
public virtual ITemplate AlternatingItemTemplate { get; set; }
[TemplateContainerAttribute(typeof(RepeaterItem))] 
public:
virtual property ITemplate^ AlternatingItemTemplate {
    ITemplate^ get ();
    void set (ITemplate^ value);
}
/** @property */
public ITemplate get_AlternatingItemTemplate ()

/** @property */
public void set_AlternatingItemTemplate (ITemplate value)
public function get AlternatingItemTemplate () : ITemplate

public function set AlternatingItemTemplate (value : ITemplate)

Eigenschaftenwert

Eine System.Web.UI.ITemplate, die definiert, wie abwechselnde Elemente dargestellt werden. Der Standardwert ist NULL (Nothing in Visual Basic).

Hinweise

Mit dieser Eigenschaft können Sie für abwechselnde Elemente im Repeater-Steuerelement eine andere Darstellung neben der in der ItemTemplate angegebenen festlegen.

Warnung

Mithilfe dieses Steuerelements können Benutzereingaben angezeigt werden, die u. U. bösartige Clientskripts enthalten. Überprüfen Sie alle von einem Client gesendeten Informationen auf ausführbare Skripts, SQL-Anweisungen oder sonstigen Code, bevor Sie sie in Ihrer Anwendung anzeigen. ASP.NET stellt ein Feature zur Anforderungsvalidierung von Eingaben bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Serversteuerelemente zur Validierung werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.

Thema Position
Gewusst wie: Hinzufügen von Repeater-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von Repeater-Webserversteuerelementen zu einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von Repeater-Webserversteuerelementen zu einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie AlternatingItemTemplate verwendet wird, um die abwechselnden Elemente des Repeater-Steuerelements in einer hellblauen Zelle und fett formatiert anzuzeigen.

<%@ 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("Apple")
            values.Add("Orange")
            values.Add("Pear")
            values.Add("Banana")
            values.Add("Grape")
            
            Repeater1.DataSource = values
            Repeater1.DataBind()
        End If
    End Sub
    
    </script>
 
 </head>
 <body>
 
    <h3>Repeater Example</h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td style="background-color: lightblue">
                   <b><%# Container.DataItem %></b> 
                </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td style="background-color: lightgray"> 
                   <%# Container.DataItem %> 
                </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </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("Apple");
             values.Add("Orange");
             values.Add("Pear");
             values.Add("Banana");
             values.Add("Grape");
 
             Repeater1.DataSource = values;
             Repeater1.DataBind();
          }
       }
    </script>
 
 </head>
 <body>
 
    <h3>Repeater Example</h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td style="background-color: lightblue">
                   <b><%# Container.DataItem %></b> 
                </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td style="background-color: lightgray"> 
                   <%# Container.DataItem %> 
                </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </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
ItemTemplate
HeaderTemplate
FooterTemplate
SeparatorTemplate

Weitere Ressourcen

Repeater-Webserver-Steuerelement