Cette documentation est archivée et n’est pas conservée.

ContentPlaceHolder, classe

Mise à jour : novembre 2007

Définit une région pour le contenu dans une page maître ASP.NET.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class ContentPlaceHolder : Control, 
	INamingContainer
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class ContentPlaceHolder extends Control implements INamingContainer
public class ContentPlaceHolder extends Control implements INamingContainer
<asp:ContentPlaceHolder />

Un contrôle ContentPlaceHolder définit une région relative pour le contenu dans une page maître et rend tout le texte, le balisage et les contrôles serveur d'un contrôle Content lié trouvé dans une page de contenu.

Un contrôle Content est associé à un ContentPlaceHolder qui utilise sa propriété ContentPlaceHolderID. Affectez la valeur de la propriété ID à la propriété ContentPlaceHolderID du contrôle ContentPlaceHolder lié dans une page maître. Plusieurs ContentPlaceHolder peuvent être déclarés dans une page maître.

Dans une page de contenu, un seul contrôle Content peut fournir le contenu d'un ContentPlaceHolder dans la page maître. Toutefois, dans chaque page de contenu qui utilise une page maître, vous pouvez avoir des contrôles Content séparés associés au ContentPlaceHolder. Par exemple, vous pouvez définir le ContentPlaceHolder du titre de page dans une page maître. Pour chaque page de contenu qui utilise la page maître, vous pouvez ajouter un contrôle Content qui fournit le texte et le balisage du titre de page.

Remarque :

Pour la conformité XHtml, un élément de titre vide est créé si un titre n'a pas été défini ou s'il est introuvable.

Vous pouvez spécifier le contenu par défaut placé dans les balises de contrôle ContentPlaceHolder, mais ce contenu est remplacé par n'importe quel contenu dans une page de contenu associée.

Pour plus d'informations sur les pages maîtres et les pages de contenu, consultez Pages maîtres ASP.NET.

TopicLocation
Comment : créer des pages de contenu pour une page maître ASP.NET (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : ajout de la navigation de site à un site WebGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Comment : créer des pages de contenu pour une page maître ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : référencer le contenu de la page maître ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : ajout de la navigation de site à un site WebGénération d'applications à l'aide de Visual Web Developer
Comment : créer des pages de contenu pour une page maître ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : référencer le contenu de la page maître ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : référencer le contenu de la page maître ASP.NETGénération d'applications Web ASP.NET

L'exemple de code suivant montre comment le contrôle ContentPlaceHolder est utilisé pour définir une région de contenu d'une page maître. La première page Web est une page maître et définit une région de contenu à l'aide d'un contrôle ContentPlaceHolder.

<%@ Master Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
    </div>
    </form>
</body>
</html>


L'exemple de code suivant illustre une page de contenu pour la page maître précédente. Le texte, le balisage et les contrôles serveur définis dans le modèle de contrôle Content s'affichent sur le ContentPlaceHolder de la page maître.

public class SampleMasterClass : System.Web.UI.MasterPage {
     private string sitename;     
     public string SiteName
     {
        get {return(sitename);}
        set {sitename = value;}
     }
}


System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.ContentPlaceHolder

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: