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 HtmlTextWriter.AddAttribute (HtmlTextWriterAttribute, String, Boolean)

 

Adicione o atributo de marcação e o valor do atributo à marca de abertura do elemento que o objeto de HtmlTextWriter cria com uma chamada subsequente ao método de RenderBeginTag , com codificação opcional.

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

public virtual void AddAttribute(
	HtmlTextWriterAttribute key,
	string value,
	bool fEncode
)

Parâmetros

key

HtmlTextWriterAttribute que representa o atributo de marcação para adicionar ao fluxo de saída.

value

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

fEncode

true para codificar o atributo e seu valor; caso contrário, false.

Use a sobrecarga de AddAttribute do método de AddAttribute(HtmlTextWriterAttribute, String, Boolean) para renderizar um atributo padrão de marcação, com codificação opcional.

Para uma instância de qualquer elemento específico de marcação, a classe de HtmlTextWriter mantém uma lista de atributos para o elemento.Quando o método de RenderBeginTag é chamado, todos os atributos adicionados por AddAttribute são renderizados a marca de abertura do elemento.A lista de atributos é desmarcada no objeto de HtmlTextWriter .

Use o método de AddAttribute(HtmlTextWriterAttribute, String, Boolean) com fEncode definido como true, se o atributo possivelmente pode conter aspas ("), menor que o sinal (<), ou um E comercial (&).A chamada do método codificará o atributo para atender aos requisitos do dispositivo de aplicativo.Você pode definir fEncode a false, se você souber que nenhum desses caracteres serão gerados, ou se você souber que o atributo está codificado já.

O padrão de codificação para renderizar os elementos de marcação é a seguinte:

  • Use o método de AddAttribute para adicionar todos os atributos para o elemento.

  • Use o método RenderBeginTag.

  • Usar outros métodos conforme necessário para renderizar o conteúdo localizado entre a abertura do elemento e fechar marcas.

  • Use o método RenderEndTag.

O exemplo de código a seguir demonstra como usar o método de AddAttribute(HtmlTextWriterAttribute, String, Boolean) para assegurar que o valor da cadeia de caracteres que é atribuído a um atributo de Alt para um elemento de <img> esteja codificado para o dispositivo de aplicativo.

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No &quot;encoding &quot; required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

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