Repeater.ItemTemplate-Eigenschaft

Artikel
08/20/2007

Ruft die System.Web.UI.ITemplate ab, die angibt, wie die Elemente im Repeater-Steuerelement angezeigt werden, oder legt diese fest

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

Syntax

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

value = instance.ItemTemplate

instance.ItemTemplate = value

[TemplateContainerAttribute(typeof(RepeaterItem))] 
public virtual ITemplate ItemTemplate { get; set; }

[TemplateContainerAttribute(typeof(RepeaterItem))] 
public:
virtual property ITemplate^ ItemTemplate {
    ITemplate^ get ();
    void set (ITemplate^ value);
}

/** @property */
public ITemplate get_ItemTemplate ()

/** @property */
public void set_ItemTemplate (ITemplate value)

public function get ItemTemplate () : ITemplate

public function set ItemTemplate (value : ITemplate)

Eigenschaftenwert

Eine System.Web.UI.ITemplate, die definiert, wie die Elemente im Repeater-Steuerelement angezeigt werden. Der Standardwert ist NULL (Nothing in Visual Basic).

Hinweise

Mit dieser Eigenschaft können Sie eine Vorlage erstellen, die steuert, wie die Elemente im Repeater-Steuerelement angezeigt werden.

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 die Verwendung eines einfachen Repeater-Steuerelements zum Anzeigen einer Tabelle mit Elementen veranschaulicht. Beachten Sie, dass ItemTemplate zum Anzeigen der einzelnen Elemente in der Datenquelle verwendet 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("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>
 
          <ItemTemplate>
             <tr>
                <td> <%# 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>
 
          <ItemTemplate>
             <tr>
                <td> <%# 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
Repeater.AlternatingItemTemplate-Eigenschaft
Repeater.HeaderTemplate-Eigenschaft
Repeater.FooterTemplate-Eigenschaft
SeparatorTemplate

Weitere Ressourcen

Repeater-Webserver-Steuerelement

Freigeben über