Syntax für Inlinevorlagen für Serversteuerelemente
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. Seitenentwickler werden feststellen, dass die Inlinevorlagensyntax für die Arbeit mit Vorlagen besonders nützlich ist: Die Anordnung und Formatierung des Inhalts von Steuerelementen lässt sich – anstatt programmgesteuert – über eine einfache deklarative Syntax festlegen. Indem Sie eine Inlinevorlage zwischen dem Start- und dem Endtag eines Serversteuerelements deklarieren, können Sie bestimmen, welche Inhalte eingefügt werden, wie diese angeordnet sind und welcher Stil darauf angewendet werden soll.
Es gibt eine ganze Reihe von ASP.NET-Webserversteuerelementen, die Vorlagen unterstützen (z. B. die Steuerelemente Repeater, DataList, Gridview, MultiView, LoginView und Menu sowie Webparts-Zonensteuerelemente wie WebPartZone und CatalogZone). Beachten Sie, dass nur Vorlagen, die im Quellcode der Klasse eines bestimmten Steuerelements definiert sind, für das Steuerelement deklariert werden können.
Vorlagenelemente müssen als untergeordnete Elemente derjenigen Serversteuerelemente deklariert werden, die sie unterstützen. Ein Serversteuerelement kann mehrere Vorlagenelemente gleichzeitig enthalten, wobei jede Vorlage die Eigenschaften eines anderen Inhaltsabschnitts 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 auch eigene Vorlagen definieren. Weitere Informationen über das Entwickeln von Steuerelementen, die Inlinestilvorlagen definieren und verwenden, finden Sie unter How to: Develop Templated Controls.
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
Referenz
Syntax für benutzerdefinierte Serversteuerelemente
Konzepte
Übersicht über die Syntax von ASP.NET-Webseiten