Ler em inglês

Compartilhar via


WebControl.AddAttributesToRender(HtmlTextWriter) Método

Definição

Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle.

protected virtual void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer);

Parâmetros

writer
HtmlTextWriter

Um HtmlTextWriter que representa o fluxo de saída para renderizar o conteúdo HTML no cliente.

Exemplos

O exemplo a seguir demonstra como criar uma classe derivada da WebControl classe . A implementação base do AddAttributesToRender método é substituída para adicionar atributos apropriados à classe derivada no HtmlTextWriter fluxo de saída.

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);
      }
   }
}

Comentários

Para renderizar atributos e estilos para um controle do Servidor Web no cliente, você normalmente chama os AddAttribute métodos e HtmlTextWriter.AddStyleAttribute para inserir cada atributo e estilo individualmente no HtmlTextWriter fluxo de saída. Para simplificar o processo, esse método encapsula todas as chamadas para os HtmlTextWriter.AddAttribute métodos e HtmlTextWriter.AddStyleAttribute para cada atributo e estilo associados ao controle do servidor Web. Todos os atributos e estilos são inseridos no HtmlTextWriter fluxo de saída em uma única chamada de método. 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 da classe .

Observação

O AddAttributesToRender método não pode ser usado para inserir o script do cliente. Para usar o script do cliente, consulte a ClientScriptManager classe .

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também