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

ContentPlaceHolder, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

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)

public class ContentPlaceHolder : Control, INamingContainer
public class ContentPlaceHolder extends Control implements INamingContainer
public class ContentPlaceHolder extends Control implements INamingContainer

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.

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.

RubriqueEmplacement
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;}
     }
}

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

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

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

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

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: