Freigeben über


Syntax für Inlinevorlagen für Serversteuerelemente

Aktualisiert: November 2007

Gibt an, welche Inhalte in ASP.NET-Serversteuerelementen, die Vorlagen unterstützen, verwendet werden und wie die Inhalte angeordnet und formatiert werden.

<templatename>
      Server control, data-binding syntax, other valid markup
</templatename>

Markuptags

  • templatename
    Der Name der Vorlage für das ASP.NET-Serversteuerelement.

Hinweise

Mit Vorlagen können Sie den Inhalt, der innerhalb von ASP.NET-Serversteuerelementen angezeigt wird, strukturieren und formatieren. Die Inlinevorlagensyntax ist für die Arbeit mit Vorlagen besonders nützlich: Die Anordnung und Formatierung des Inhalts von Steuerelementen lässt sich – anstatt programmgesteuert – über eine einfache deklarative Syntax festlegen.

Eine Reihe von ASP.NET-Webserversteuerelementen unterstützen Vorlagen, beispielsweise die Steuerelemente Repeater, DataList, GridView, FormView, MultiView, LoginView und Menu sowie Webparts-Zonensteuerelemente wie WebPartZone und CatalogZone. Beachten Sie, dass nur die Vorlagen, die für ein Steuerelement speziell definiert sind, für dieses Steuerelement deklariert werden können.

Vorlagenelemente müssen als untergeordnete Elemente derjenigen Serversteuerelemente deklariert werden, die sie unterstützen. Ein Serversteuerelement kann mehrere Vorlagenelemente enthalten, wobei jede Vorlage die Eigenschaften eines anderen Inhalts im Steuerelement angibt. So unterstützt z. B. das Repeater-Steuerelement Vorlagen, mit denen Sie das Layout und die Darstellung von Inhalten innerhalb eines Header-, Text- , Element- oder Footerabschnitts angeben können, sowie besondere Vorlagen zum Behandeln von Stilen für alternierende Elemente und Trennzeichen zwischen Elementen. Ausführliche Informationen finden Sie im Codebeispiel in diesem Thema.

Um anzugeben, wie der Inhalt innerhalb einer Vorlage angezeigt wird, müssen Sie zusätzliche Elemente innerhalb der Vorlagentags deklarieren. Das zusätzliche Markup kann aus HTML-Tags, ASP.NET-Steuerelementen und serverseitigen Inlineausdrücken oder Codeblöcken bestehen. Weitere Informationen zum Verwenden von Inlinevorlagen finden Sie unter Vorlagen für ASP.NET-Webserver-Steuerelemente.

Sie können beim Entwickeln von benutzerdefinierten Serversteuerelementen eigene Vorlagen definieren. Weitere Informationen über das Entwickeln von Steuerelementen, die Inlinestilvorlagen definieren und verwenden, finden Sie unter Gewusst wie: Erstellen von vorlagenbasierten ASP.NET-Benutzersteuerelementen.

Beispiel

Das folgende Codebeispiel zeigt, wie Sie die HeaderTemplate-Vorlage, die AlternatingItemTemplate-Vorlage, die ItemTemplate-Vorlage und die FooterTemplate-Vorlage in einem Repeater-Webserversteuerelement deklarieren. Jede dieser Vorlagen wird einer Eigenschaft der Repeater-Klasse zugeordnet.

<%@ Page Language="C#" %>
<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><font face="Verdana">Repeater Example</font></h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td><b> <%# Container.DataItem %> </b> </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>
<%@ Page Language="VB" %> 
<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><font face="Verdana">Repeater Example</font></h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td><b> <%# Container.DataItem %> </b> </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>

          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>    

Siehe auch

Aufgaben

Gewusst wie: Erstellen von vorlagenbasierten ASP.NET-Benutzersteuerelementen

Konzepte

Übersicht über die Syntax von ASP.NET-Webseiten

Referenz

Syntax für benutzerdefinierte Serversteuerelemente