Vorlagen für Webserversteuerelemente

Die meisten Webserversteuerelemente haben eine Standarddarstellung und ein Standardlayout. Diese Einstellungen können durch Festlegen von Eigenschaften und mit Formatvorlagen geändert werden. Bei manchen Webserversteuerelementen können Sie das Aussehen auch über Vorlagen anpassen.

Eine Vorlage ist eine Gruppe von HTML-Elementen und Steuerelementen, die das Layout für einen bestimmten Teil eines Steuerelements bilden. Im DataList-Webserversteuerelement können Sie z. B. eine Kombination von HTML-Elementen und Steuerelementen verwenden, um das Layout für die einzelnen Zeilen der Liste zu erstellen. Genauso verfügt das DataGrid-Webserversteuerelement über eine Standarddarstellung für Datenblattzeilen. Sie können die Darstellung des Datenblattes allerdings anpassen, indem Sie verschiedene Vorlagen für einzelne Zeilen, Zeilen mit abwechselnden Elementen, markierte Zeilen usw. definieren.

**Hinweis   **Vorlagen unterscheiden sich von Formaten. Eine Vorlage definiert den Inhalt eines Steuerelementbereichs, z. B. den Inhalt einer Zeile im DataList-Steuerelement. Formate hingeben geben die Darstellung von Elementen an, z. B. Farbe, Schriftart usw. Formate können einem Steuerelement als Ganzem (z. B. zum Festlegen der Schriftart für das DataGrid-Steuerelement) als auch Vorlagenelementen zugewiesen werden.

Vorlagen bestehen aus HTML-Elementen und sogar eingebetteten Serversteuerelementen. Wenn das Steuerelement auf der Web Forms-Seite ausgeführt wird, gibt das Gerüst des Steuerelements den Inhalt der Vorlage und nicht die HTML-Standardelemente für das Steuerelement wieder.

Welche Steuerelemente unterstützen Vorlagen?

Nicht alle Webserversteuerelemente unterstützen Vorlagen. Meistens werden Vorlagen von komplexen Steuerelementen unterstützt. In Visual Studio gehören dazu das DataGrid-Webserversteuerelement, das DataList-Webserversteuerelement und das Repeater-Webserversteuerelement. (Das Repeater-Steuerelement und das DataList-Steuerelement unterstützen nicht nur Vorlagen, sondern erfordern das Erstellen von Vorlagen, um die Ausgabe dieser Steuerelemente zu definieren.) Steuerelemente, die Sie von anderen Quellen erhalten, können ebenfalls Vorlagen unterstützen.

Jedes Steuerelement unterstützt eine etwas andere Gruppe von Vorlagen, die Layouts für verschiedene Teile des Steuerelements (z. B. Header, Footer, Element und ausgewähltes Element) angeben. Je nachdem, was angepasst werden soll, können Sie eine Vorlage für beliebige oder alle Elemente angeben. Im DataGrid-Steuerelement können Sie Vorlagen für Spalten (und nicht für Zeilen) angeben.

In der folgenden Tabelle sind die Webserversteuerelemente zusammengefasst, die Vorlagen unterstützen.

Steuerelement	Vorlagen
"Repeater"	HeaderTemplate FooterTemplate ItemTemplate AlternatingItemTemplate SeparatorTemplate
"DataList"	HeaderTemplate FooterTemplate ItemTemplate AlternatingItemTemplate SeparatorTemplate SelectedItemTemplate EditItemTemplate
"DataGrid"	HeaderTemplate FooterTemplate ItemTemplate (Spalte) EditItemTemplate (Spalte) Pager

Erstellen von Vorlagen

Der Web Forms-Designer enthält eine Funktion, mit der Sie Vorlagen im WYSIWYG-Modus entwerfen können. Sie öffnen dazu einen speziellen Vorlagenbearbeitungsmodus, der die Vorlagen des Steuerelements in der Entwurfsansicht darstellt. Sie können HTML-Code eingeben und Steuerelemente aus der Toolbox direkt in die Vorlage ziehen, die Sie bearbeiten.

Sie können Vorlagen auch direkt in der ASPX-Datei erstellen. Vorlagen werden als XML-Deklarationen erstellt. Das folgende Beispiel zeigt, wie Sie eine Liste mit Mitarbeiternamen, Telefonnummern und E-Mail-Adressen mit Hilfe von Vorlagen im DataList-Webserversteuerelement darstellen können. Das Layout der Mitarbeiterdaten wird in ItemTemplate mit datengebundenen Steuerelementen angegeben.

<asp:datalist ID="DataList1" runat="server">
   <HeaderTemplate>
      Employee List
   </HeaderTemplate>
   <ItemTemplate>
      <asp:label id=Label1 runat="server" 
         Text='<%# DataBinder.Eval(Container, "DataItem.EmployeeName")
         %>'></asp:label>
      <asp:label id=Label2 runat="server" 
         Text='<%# DataBinder.Eval(Container, "DataItem.PhoneNumber")
         %>'></asp:label>
      <asp:Hyperlink id=Hyperlink1 runat="server" 
         Text='<%# DataBinder.Eval(Container, "DataItem.Email") %>'
         NavigateURL='<%# DataBinder.Eval(Container, "DataItem.Link") %>'>
      </asp:Hyperlink>
   </ItemTemplate>
</asp:datalist>

Siehe auch

Erstellen von Vorlagen für Webserversteuerelemente | Dynamisches Erstellen von Vorlagen für Webserversteuerelemente | ASP.NET-Serversteuerelemente | ASP.NET-Serversteuerelemente und CSS-Formatvorlagen | Datenbindung in Web Forms | Dynamisches Erstellen von Vorlagen für Webserversteuerelemente | Programmgesteuertes Erstellen von Vorlagen im DataGrid-Steuerelement