Exporter (0) Imprimer
Développer tout

WebControl.AddAttributesToRender, méthode

Mise à jour : novembre 2007

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

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

protected virtual void AddAttributesToRender(
	HtmlTextWriter writer
)
protected void AddAttributesToRender(
	HtmlTextWriter writer
)
protected function AddAttributesToRender(
	writer : HtmlTextWriter
)

Paramètres

writer
Type : System.Web.UI.HtmlTextWriter

HtmlTextWriter qui représente le flux de sortie utilisé pour rendre le contenu HTML sur le client.

Pour rendre des attributs et des styles pour un contrôle serveur Web sur le client, vous appelez généralement les méthodes AddAttribute et HtmlTextWriter.AddStyleAttribute pour insérer individuellement chaque attribut ou style dans le flux de sortie HtmlTextWriter. Pour simplifier le processus, cette méthode encapsule tous les appels aux méthodes HtmlTextWriter.AddAttribute et HtmlTextWriter.AddStyleAttribute pour chaque attribut ou style associé au contrôle serveur Web. Tous les attributs et styles sont insérés dans le flux de sortie HtmlTextWriter dans un seul appel de méthode. Cette méthode est généralement substituée par les développeurs de contrôles dans les classes dérivées pour insérer les attributs et styles appropriés dans le flux de sortie HtmlTextWriter pour la classe.

Remarque :

La méthode AddAttributesToRender ne peut pas être utilisée pour insérer le script client. Pour utiliser le script client, consultez la classe ClientScriptManager.

L'exemple suivant illustre la création d'une classe qui dérive de la classe WebControl. L'implémentation de base de la méthode AddAttributesToRender est substituée pour ajouter les attributs appropriés à la classe dérivée dans le flux de sortie HtmlTextWriter.

namespace ControlTest 
{
   using System;
   using System.Web.UI;
   using System.Web.UI.WebControls;

   // Renders the following HTML: 
   // <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>

   public class MyWebControl: WebControl {

      public MyWebControl() : base(HtmlTextWriterTag.Span) 
      { }

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override void AddAttributesToRender(HtmlTextWriter writer) 
      {

         writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
         writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
         base.AddAttributesToRender(writer);

      }

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override void RenderContents(HtmlTextWriter writer) 
      {
         writer.Write("Custom Contents");
         base.RenderContents(writer);
      }
   }
}



package ControlTest; 
import System.*;
import System.Web.UI.*;
import System.Web.UI.WebControls.*;

// Renders the following HTML: 
// <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
public class MyWebControl extends WebControl
{
    public MyWebControl()
    {
         super(HtmlTextWriterTag.Span);
    } //MyWebControl

    protected void AddAttributesToRender(HtmlTextWriter writer)
    {
        writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
        writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
        super.AddAttributesToRender(writer);
    } //AddAttributesToRender

    /** @attribute System.Security.Permissions.PermissionSet(System.Security.
        Permissions.SecurityAction.Demand, Name = "FullTrust")
     */
    protected void RenderContents(HtmlTextWriter writer)
    {
        writer.Write("Custom Contents");
        super.RenderContents(writer);
    } //RenderContents
} //MyWebControl


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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft