WebControl.AddAttributesToRender(HtmlTextWriter) Méthode

  • Référence

Définition

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

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.

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

HtmlTextWriter qui représente le flux de sortie utilisé pour restituer 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 remplacée pour ajouter des attributs appropriés à la classe dérivée dans le flux de HtmlTextWriter 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 Serveur Web sur le client, vous appelez généralement les AddAttribute méthodes et HtmlTextWriter.AddStyleAttribute pour insérer chaque attribut et style individuellement dans le flux de HtmlTextWriter sortie. Pour simplifier le processus, cette méthode encapsule tous les appels aux HtmlTextWriter.AddAttribute méthodes et HtmlTextWriter.AddStyleAttribute pour chaque attribut et style associé au contrôle serveur Web. Tous les attributs et styles sont insérés dans le flux de HtmlTextWriter 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 des classes dérivées pour insérer les attributs et styles appropriés dans le flux de HtmlTextWriter sortie de la classe .

Notes

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

S’applique à

Voir aussi