WebControl.AddAttributesToRender(HtmlTextWriter) Méthode

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

protected:
 virtual void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer);
abstract member AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
override this.AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub AddAttributesToRender (writer As HtmlTextWriter)

Paramètres

writer
HtmlTextWriter

Qui HtmlTextWriter représente le flux de sortie pour afficher le contenu HTML sur le client.

Exemples

L’exemple suivant montre comment créer une classe qui dérive de la WebControl classe. L’implémentation de base de la AddAttributesToRender méthode est substituée pour ajouter des attributs appropriés à la classe dérivée dans le HtmlTextWriter flux de sortie.

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


Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace ControlTest
   
   ' Renders the following HTML: 
   ' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
   Public Class MyWebControl
      Inherits WebControl
      
      
      Public Sub New()
         MyBase.New(HtmlTextWriterTag.Span)
      End Sub
      
      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter)
         
         writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
         writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
         MyBase.AddAttributesToRender(writer)

      End Sub

      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub RenderContents(writer As HtmlTextWriter)
         writer.Write("Custom Contents")
         MyBase.RenderContents(writer)
      End Sub

   End Class

End Namespace 'ControlTest

Remarques

Pour afficher des attributs et des styles pour un contrôle Web Server sur le client, vous appelez généralement les méthodes et HtmlTextWriter.AddStyleAttribute les AddAttribute attributs pour insérer chaque attribut et style individuellement dans le HtmlTextWriter flux de sortie. Pour simplifier le processus, cette méthode encapsule tous les appels aux méthodes et HtmlTextWriter.AddStyleAttribute aux HtmlTextWriter.AddAttribute attributs de chaque attribut et style associé au contrôle serveur Web. Tous les attributs et styles sont insérés dans le HtmlTextWriter flux de sortie dans un appel de méthode unique. Cette méthode est généralement remplacé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 HtmlTextWriter flux de sortie de la classe.

Note

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

S’applique à

Voir aussi