Syntaxe de modèle inline de contrôle serveur
[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]
Spécifie le contenu à inclure ainsi que la disposition et les styles appliqués dans les contrôles serveur ASP.NET qui prennent en charge les modèles.
<templatename>
Server control, data-binding syntax, other valid markup
</templatename>
Instructions de balisage
- templatename
Nom du modèle de contrôle serveur ASP.NET.
Notes
Les modèles peuvent être utilisés pour structurer et appliquer des styles au contenu qui apparaît dans des contrôles serveur ASP.NET. La syntaxe de modèle inline offre un moyen pratique pour la manipulation de modèles, car elle vous permet de concevoir la disposition et le style du contenu d'un contrôle dans une syntaxe déclarative simple au lieu de le faire par programme.
De nombreux contrôles serveur Web ASP.NET prennent en charge des modèles (par exemple, les contrôles Repeater, DataList, GridView, FormView, MultiView, LoginView et Menu prennent tous en charge les modèles, au même titre que les contrôles de zone WebParts, notamment WebPartZone et CatalogZone). Notez que seuls les modèles qui sont définis spécifiquement pour un contrôle peuvent être déclarés réellement pour ce contrôle.
Les éléments de modèle doivent être déclarés en tant qu'éléments enfants des contrôles serveur qui les prennent en charge. Un contrôle serveur peut contenir plusieurs éléments de modèle, chaque modèle utilisé spécifiant les caractéristiques d'une section différente du contenu dans le contrôle. Par exemple, le contrôle Repeater prend en charge des modèles pour spécifier la disposition et l'apparence du contenu dans une section d'en-tête, une section de corps ou d'élément et une section de pied de page ainsi que des modèles spéciaux pour gérer les styles des éléments de remplacement et des séparateurs d'éléments. Pour des informations plus détaillées, consultez l'exemple de code proposé dans cette rubrique.
Pour préciser comment le contenu apparaîtra dans un modèle, déclarez des éléments supplémentaires dans les balises du modèle. Ce balisage supplémentaire peut se composer de balises HTML, de contrôles ASP.NET et de blocs de code ou d'expressions côté serveur inline. Pour plus d'informations sur l'utilisation de modèles inline, consultez ASP.NET Web Server Controls Templates.
Vous pouvez définir vos propres modèles lorsque vous développez des contrôles serveur personnalisés. Pour plus d'informations sur le développement de contrôles qui définissent et utilisent des modèles de style inline, consultez How to: Create Templated ASP.NET User Controls.
Exemple
L'exemple de code suivant montre comment déclarer les modèles HeaderTemplate, AlternatingItemTemplate, ItemTemplate et FooterTemplate dans un contrôle serveur Web Repeater. Chacun de ces modèles est associé à une propriété de la classe Repeater.
<%@ 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>
Voir aussi
Tâches
How to: Create Templated ASP.NET User Controls
Référence
Syntaxe de contrôle serveur personnalisé