WebControl.AddAttributesToRender(HtmlTextWriter) Método
Definição
Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Esse método é usado principalmente por desenvolvedores de controle.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)
Parâmetros
- writer
- HtmlTextWriter
Um HtmlTextWriter que representa o fluxo de saída para renderizar o conteúdo HTML no cliente.A HtmlTextWriter that represents the output stream to render HTML content on the client.
Exemplos
O exemplo a seguir demonstra como criar uma classe derivada da WebControl classe.The following example demonstrates how to create a class that derives from the WebControl class. A implementação base do AddAttributesToRender método é substituída para adicionar atributos apropriados à classe derivada no fluxo de HtmlTextWriter saída.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
Comentários
Para renderizar atributos e estilos de um controle de servidor Web no cliente, você normalmente chama AddAttribute os HtmlTextWriter.AddStyleAttribute métodos e para inserir cada atributo e estilo individualmente no HtmlTextWriter fluxo de saída.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. Para simplificar o processo, esse método encapsula todas as chamadas para HtmlTextWriter.AddAttribute os HtmlTextWriter.AddStyleAttribute métodos e para cada atributo e estilo associado ao controle do servidor 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. Todos os atributos e estilos são inseridos no HtmlTextWriter fluxo de saída em uma única chamada de método.All attributes and styles are inserted into the HtmlTextWriter output stream in a single method call. Esse método é normalmente substituído por desenvolvedores de controle em classes derivadas para inserir os atributos e estilos apropriados no HtmlTextWriter fluxo de saída para a 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.
Observação
O AddAttributesToRender método não pode ser usado para inserir o script do cliente.The AddAttributesToRender method cannot be used to insert client script. Para usar o script de cliente, consulte a ClientScriptManager classe.To use client script, see the ClientScriptManager class.