WebControl.AddAttributesToRender(HtmlTextWriter) Method

Definition

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

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)

Parameters

writer
HtmlTextWriter

HtmlTextWriter qui représente le flux de sortie utilisé pour restituer le contenu HTML sur le client.A HtmlTextWriter that represents the output stream to render HTML content on the client.

Examples

L’exemple suivant montre comment créer une classe qui dérive de la classe WebControl.The following example demonstrates how to create a class that derives from the WebControl class. L’implémentation de base de la méthode AddAttributesToRender est substituée pour ajouter des attributs appropriés à la classe dérivée dans le flux de sortie HtmlTextWriter.The base implementation of the AddAttributesToRender method is overridden to add attributes appropriate to the derived class in the HtmlTextWriter output stream.

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

Remarks

Pour afficher les attributs et les 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 et chaque style dans le flux de sortie HtmlTextWriter.To render attributes and styles for a Web Server control on the client, you typically call the AddAttribute and HtmlTextWriter.AddStyleAttribute methods to insert each attribute and style individually to the HtmlTextWriter output stream. Pour simplifier le processus, cette méthode encapsule tous les appels aux méthodes HtmlTextWriter.AddAttribute et HtmlTextWriter.AddStyleAttribute pour chaque attribut et style associés au contrôle serveur Web.To simplify the process, this method encapsulates all calls to the HtmlTextWriter.AddAttribute and HtmlTextWriter.AddStyleAttribute methods for every attribute and style associated with the Web server control. Tous les attributs et les styles sont insérés dans le flux de sortie HtmlTextWriter dans un appel de méthode unique.All attributes and styles are inserted into the HtmlTextWriter output stream in a single method call. 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 les styles appropriés dans le flux de sortie HtmlTextWriter pour la classe.This method is typically overridden by control developers in derived classes to insert the appropriate attributes and styles to the HtmlTextWriter output stream for the class.

Note

La méthode AddAttributesToRender ne peut pas être utilisée pour insérer un script client.The AddAttributesToRender method cannot be used to insert client script. Pour utiliser le script client, consultez la classe ClientScriptManager.To use client script, see the ClientScriptManager class.

Applies to

See also