Référence de la syntaxe Web Forms
Éléments de la syntaxe ASP.NET Web Forms
Une page Web Forms ASP.NET est un fichier texte déclaratif portant une extension de nom de fichier .aspx. Outre le contenu statique, vous pouvez utiliser huit éléments de balisage de syntaxe différents. Cette section du didacticiel Démarrage rapide décrit chacun de ces éléments de syntaxe et fournit des exemples illustrant leur utilisation.
Syntaxe du code de restitution : <% %> et <%= %>
Les blocs de restitution du code sont désignés par les éléments <% … %> et vous permettent de personnaliser le contrôle de l'émission de contenu. Ils s'exécutent pendant la phase de restitution de l'exécution de la page Web Forms. L'exemple suivant illustre l'utilisation de ces éléments pour exécuter une boucle sur le contenu HTML.
<% for (int i=0; i<8; i++) { %>
<font size="<%=i%>"> Bonjour!
</font> <br>
<% } %>
<% For I=0 To 7 %>
<font size="<%=i%>"> Bonjour!
</font> <br>
<% Next %>
<% for (var i:int=0; i<8; i++) { %>
<font size="<%=i%>"> Bonjour!
</font> <br>
<% } %>
|
|
C#
|
VB
|
JScript
|
|
Le code entouré de <% ... %> s'exécute simplement, alors que les expressions contenant un signe égal, <%= ... %>, sont évaluées et le résultat est émis en tant que contenu. Par conséquent, <%="Bonjour" %> restitue les mêmes données que le code C# <% Response.Write("Bonjour"); %>.
Remarque : Pour les langages utilisant des marques pour terminer ou séparer les instructions (par exemple, un point-virgule (;) dans C#), il est important de placer ces marques correctement selon la manière dont votre code doit être restitué.
| Code C# |
|---|
<% Response.Write("Bonjour"); %> |
L'instruction doit se terminer par un point-virgule. |
<%="Bonjour"; %> |
Incorrect : Donnerait "Response.Write("Bonjour";);". |
<%="Bonjour" %> | Le point-virgule n'est pas nécessaire. |
Syntaxe du code de déclaration : <script runat="server">
Les blocs de déclaration de code définissent les variables et les méthodes membres qui doivent être compilées dans la classe Page générée. Ces blocs peuvent être utilisés pour créer la logique page/navigation. L'exemple suivant illustre la manière dont une méthode Subtract peut être déclarée au sein d'un bloc <script runat="server">, puis appelée à partir de la page.
<script language="C#" runat=server>
int subtract(int num1, int num2) {
return num1 - num2;
}
</script>
<%
...
number = subtract(number, 1);
...
%>
<script language="VB" runat=server>
Function Subtract(num1 As
Integer, num2 As Integer) As Integer
Return(num1 - num2)
End Function
</script>
<%
...
number = subtract(number, 1)
...
%>
<script language="JScript" runat=server>
function subtract(num1:int, num2:int) : int {
return num1 - num2;
}
</script>
<%
...
number = subtract(number, 1);
...
%>
|
|
C#
|
VB
|
JScript
|
|
Important : Contrairement à ASP (où les fonctions pouvaient être déclarées au sein de blocs <% %>), toutes les fonctions et variables de pages globales doivent être déclarées dans une balise <script runat=server>. Les fonctions déclarées au sein de blocs <% %> génèrent à présent une erreur de compilation de syntaxe.
Syntaxe des contrôles serveur ASP.NET
Les contrôles serveur ASP.NET personnalisés permettent aux développeurs de pages de générer une interface utilisateur de manière dynamique et de répondre aux demandes des clients. Ils sont représentés au sein d'un fichier à l'aide d'une syntaxe déclarative basée sur des balises. Ces balises se distinguent des autres, car elles contiennent un attribut "runat=server". L'exemple suivant illustre l'utilisation d'un contrôle serveur <asp:label runat="server"> au sein d'une page ASP.NET. Ce contrôle correspond à la classe Label de l'espace de noms System.Web.UI.WebControls, qui est incluse par défaut.
Si vous ajoutez une balise portant l'ID "Message", une instance de Label est créée au moment de l'exécution :
<asp:label id="Message"
font-size=24 runat="server"/>
Message.Text = "Bienvenue dans ASP.NET";
Message.Text = "Bienvenue dans ASP.NET"
Message.Text = "Bienvenue dans ASP.NET";
|
|
C#
|
VB
|
JScript
|
|
Syntaxe des contrôles serveur HTML ASP.NET
Les contrôles serveur HTML permettent aux développeurs de pages de manipuler par programme des éléments HTML au sein d'une page. Une balise de contrôle serveur HTML se distingue des éléments HTML clients par la présence d'un attribut "runat=server". L'exemple suivant illustre l'utilisation d'un contrôle serveur <span runat=server> HTML au sein d'une page ASP.NET.
Comme pour les autres contrôles serveur, les méthodes et propriétés sont accessibles par programme, comme le montre l'exemple suivant.
<script language="C#" runat="server">
void Page_Load(Object
sender, EventArgs e) {
Message.InnerHtml =
"Bienvenue dans ASP.NET";
}
</script>
...
<span id="Message" style="font-size:24" runat="server"/>
<script language="VB"
runat="server">
Sub Page_Load(sender
As Object, e As EventArgs)
Message.InnerHtml =
"Bienvenue dans ASP.NET"
End Sub
</script>
...
<span id="Message"
style="font-size:24" runat="server"/>
<script language="JScript"
runat="server">
function Page_Load(sender:Object
, e:EventArgs) : void {
Message.InnerHtml =
"Bienvenue dans ASP.NET";
}
</script>
...
<span id="Message"
style="font-size:24" runat="server"/>
|
|
C#
|
VB
|
JScript
|
|
Syntaxe de liaison de données : <%# %>
La prise en charge de la liaison de données intégrée dans ASP.NET permet aux développeurs de pages de lier hiérarchiquement des propriétés de contrôle à des valeurs de conteneurs de données. Le code situé dans un bloc de code <%# %> ne s'exécute que si la méthode DataBind de son conteneur de contrôle parent est appelée. L'exemple suivant illustre l'utilisation de la syntaxe de liaison de données au sein d'un contrôle <asp:datalist runat=server>.
Dans liste de données, le modèle d'un élément est spécifié. Le contenu du modèle d'élément est spécifié à l'aide d'une expression de liaison de données et Container.DataItem fait référence à la source de données utilisée par la liste de données MyList.
<asp:datalist id="MyList" runat=server>
<ItemTemplate>
Here is a value: <%#
Container.DataItem %>
</ItemTemplate>
</asp:datalist>
MyList est définie par programme, puis DataBind() est appelé.
void Page_Load(Object
sender, EventArgs e) {
ArrayList items = new ArrayList();
items.Add("One");
items.Add("Two");
items.Add("Three");
MyList.DataSource = items;
MyList.DataBind();
}
Sub Page_Load(sender As Object,
e As EventArgs)
Dim items As New ArrayList()
items.Add("One")
items.Add("Two")
items.Add("Three")
MyList.DataSource = items
MyList.DataBind()
End Sub
function Page_Load(sender:Object
, e:EventArgs) : void {
var items:ArrayList =
new ArrayList();
items.Add("One");
items.Add("Two");
items.Add("Three");
MyList.DataSource = items;
MyList.DataBind();
}
|
|
C#
|
VB
|
JScript
|
|
L'appel de la méthode DataBind d'un contrôle entraîne un parcours récursif à partir de ce contrôle jusqu'au bas de l'arborescence. L'événement DataBinding se déclenche pour chaque contrôle serveur de cette hiérarchie et les expressions de liaison de données des contrôles sont évaluées en conséquence. Ainsi, si la méthode DataBind de la page est appelée, toutes les expressions de liaison de données de la page le sont également.
Syntaxe des balises object : <object runat="server" />
Les balises object permettent aux développeurs de déclarer et de créer des instances de variables à l'aide d'une syntaxe déclarative basée sur les balises. L'exemple suivant illustre l'utilisation de la balise object pour créer une instance d'une classe ArrayList.
<object id="items"
class="System.Collections.ArrayList
" runat="server"/>
void Page_Load(Object sender,
EventArgs e) {
items.Add("One");
items.Add("Two");
items.Add("Three");
...
}
Sub Page_Load(sender As Object,
e As EventArgs)
items.Add("One")
items.Add("Two")
items.Add("Three")
...
End Sub
function Page_Load(sender:Object,
e:EventArgs) : void {
items.Add("One");
items.Add("Two");
items.Add("Three");
...
}
|
|
C#
|
VB
|
JScript
|
|
Syntaxe des commentaires côté serveur : <%-- Commentaire --%>
Les commentaires côté serveur permettent aux développeurs de pages d'éviter l'exécution ou la restitution du code serveur (y compris les contrôles serveur) et du contenu statique. L'exemple suivant illustre comment empêcher le contenu de s'exécuter et d'être envoyé à un client. Remarquez que toute la partie située entre <%-- et --%> est filtrée et n'est visible que dans le fichier serveur d'origine, bien qu'elle contienne d'autres directives ASP.NET.
<%--
<asp:calendar id="MyCal"
runat=server/>
<% for (int i=0; i<45; i++) { %>
Bonjour <br>
<% } %>
--%>
<%--
<asp:calendar id="MyCal"
runat=server/>
<% For I=0 To 44 %>
Bonjour <br>
<% Next %>
--%>
<%--
<asp:calendar id="MyCal"
runat=server/>
<% for (var i:int=0; i<45; i++) { %>
Bonjour <br>
<% } %>
--%>
|
|
C#
|
VB
|
JScript
|
|
Syntaxe des inclusions côté serveur : <-- #Include File="Locaton.inc" -->
Les inclusions #Includes côté serveur permettent aux développeurs d'insérer le contenu brut d'un fichier spécifié à n'importe quel endroit d'une page ASP.NET. L'exemple suivant illustre l'insertion d'un en-tête et d'un pied de page personnalisés au sein d'une page.
<!-- #Include File="Header.inc" -->
...
<!-- #Include File="Footer.inc" -->
|
Vérifiez
