Syntaxe déclarative du contrôle serveur Web PlaceHolder
Mise à jour : novembre 2007
Réserve aux contrôles ajoutés par programme un emplacement dans la hiérarchie des contrôles de la page.
<asp:PlaceHolder
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Visible="True|False"
/>
Notes
Utilisez le contrôle PlaceHolder comme conteneur pour stocker des contrôles serveur ajoutés dynamiquement à la page Web. Le contrôle PlaceHolder ne génère aucune sortie visible et est uniquement utilisé comme conteneur d'autres contrôles de la page Web. Vous pouvez utiliser la collection Control.Controls pour ajouter, insérer ou supprimer un contrôle du contrôle PlaceHolder.
Exemple
L'exemple suivant montre comment ajouter des contrôles serveur Web au contrôle PlaceHolder.
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>PlaceHolder Example</title>
<script runat="server">
Sub Page_Load(Sender As Object, e As EventArgs)
Dim myButton As HtmlButton = New HtmlButton()
myButton.InnerText = "Button 1"
PlaceHolder1.Controls.Add(myButton)
myButton = New HtmlButton()
myButton.InnerText = "Button 2"
PlaceHolder1.Controls.Add(myButton)
myButton = New HtmlButton()
myButton.InnerText = "Button 3"
PlaceHolder1.Controls.Add(myButton)
myButton = New HtmlButton()
myButton.InnerText = "Button 4"
PlaceHolder1.Controls.Add(myButton)
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>PlaceHolder Example</h3>
<asp:PlaceHolder id="PlaceHolder1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>PlaceHolder Example</title>
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
HtmlButton myButton = new HtmlButton();
myButton.InnerText = "Button 1";
PlaceHolder1.Controls.Add(myButton);
myButton = new HtmlButton();
myButton.InnerText = "Button 2";
PlaceHolder1.Controls.Add(myButton);
myButton = new HtmlButton();
myButton.InnerText = "Button 3";
PlaceHolder1.Controls.Add(myButton);
myButton = new HtmlButton();
myButton.InnerText = "Button 4";
PlaceHolder1.Controls.Add(myButton);
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>PlaceHolder Example</h3>
<asp:PlaceHolder id="PlaceHolder1"
runat="server"/>
</form>
</body>
</html>