WebControl.AddAttributesToRender(HtmlTextWriter) Método

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Agrega atributos y estilos HTML que se deben representar en el HtmlTextWriterTag especificado. Este método lo usan principalmente los desarrolladores de controles.

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)

Parámetros

writer: HtmlTextWriter

HtmlTextWriter que representa el flujo de salida para representar contenido HTML en el cliente.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una clase que deriva de la WebControl clase . La implementación base del AddAttributesToRender método se reemplaza para agregar atributos adecuados a la clase derivada en el HtmlTextWriter flujo de salida.

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

Comentarios

Para representar atributos y estilos para un control de servidor web en el cliente, normalmente se llama a los AddAttribute métodos y HtmlTextWriter.AddStyleAttribute para insertar cada atributo y estilo individualmente en el HtmlTextWriter flujo de salida. Para simplificar el proceso, este método encapsula todas las llamadas a los HtmlTextWriter.AddAttribute métodos y HtmlTextWriter.AddStyleAttribute para cada atributo y estilo asociado al control de servidor web. Todos los atributos y estilos se insertan en el HtmlTextWriter flujo de salida en una sola llamada de método. Normalmente, este método se reemplaza por los desarrolladores de controles en clases derivadas para insertar los atributos y estilos adecuados en el HtmlTextWriter flujo de salida de la clase.

Nota

El AddAttributesToRender método no se puede usar para insertar el script de cliente. Para usar el script de cliente, consulte la ClientScriptManager clase .

Se aplica a

Compartir vía