Syntax für Inlinevorlagen für Serversteuerelemente
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
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 ASP.NET Web Server Controls Templates.
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 How to: Create Templated ASP.NET User 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
Aufgaben
How to: Create Templated ASP.NET User Controls
Referenz
Syntax für benutzerdefinierte Serversteuerelemente