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

Control.Render, méthode

Mise à jour : novembre 2007

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client.

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

protected internal virtual void Render(
	HtmlTextWriter writer
)
protected void Render(
	HtmlTextWriter writer
)
protected internal function Render(
	writer : HtmlTextWriter
)

Paramètres

writer
Type : System.Web.UI.HtmlTextWriter

Objet HtmlTextWriter qui reçoit le contenu du contrôle serveur.

Lorsque vous développez des contrôles serveur personnalisés, vous pouvez substituer cette méthode afin de générer un contenu pour une page ASP.NET.

L'exemple de code suivant illustre la substitution de la méthode Render. La méthode HasControls est utilisée pour déterminer si le contrôle serveur possède des contrôles enfants stockés dans son objet ControlCollection, qui est accessible par l'intermédiaire de la propriété Control.Controls. Si HasControls retourne true et que le premier contrôle serveur dans la collection est un texte littéral, ce dernier est alors ajouté à une chaîne HTML.

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
protected override void Render(HtmlTextWriter output) {
    if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
        output.Write("<H2>Your Message: " + ((LiteralControl) Controls[0]).Text + "</H2>");
    }
}


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, 1.1, 1.0
Afficher: