WebControl.AddAttributesToRender(HtmlTextWriter) Méthode

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 les attributs et les styles d’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 HtmlTextWriter flux de 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 à

Partager via