Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método WebControl.AddAttributesToRender (HtmlTextWriter)

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

protected virtual void AddAttributesToRender(
	HtmlTextWriter writer
)

Parâmetros

writer
Type: System.Web.UI.HtmlTextWriter

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

Para processar atributos e estilos de um controle de servidor Web no cliente, normalmente você chama o AddAttribute e HtmlTextWriter.AddStyleAttribute métodos para inserir cada atributo e Estilizar individualmente para o HtmlTextWriter fluxo de saída. Para simplificar o processo, este método encapsula todas as chamadas para o HtmlTextWriter.AddAttribute e HtmlTextWriter.AddStyleAttribute métodos para cada atributo e o estilo associado ao controle de servidor Web. Todos os atributos e estilos são inseridos a 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 apropriados e estilos para o HtmlTextWriter fluxo de saída para a classe.

System_CAPS_noteObservação

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

O exemplo a seguir demonstra como criar uma classe que deriva de WebControl classe. A implementação base do AddAttributesToRender método é substituído para adicionar atributos apropriados para a classe derivada de 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);
      }
   }
}

.NET Framework
Disponível desde 1.1
Retornar ao início
Mostrar: