Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método HtmlTextWriter.AddAttribute (HtmlTextWriterAttribute, String, Boolean)

Adiciona o atributo de marcação e o valor do atributo na marca de abertura do elemento que a HtmlTextWriter cria um objeto com uma chamada subseqüente para o RenderBeginTag método, 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
Tipo: System.Web.UI.HtmlTextWriterAttribute
Um HtmlTextWriterAttribute que representa o atributo de marcação para adicionar o fluxo de saída.
value
Tipo: System.String
Uma seqüência de caracteres que contém o valor para atribuir ao atributo.
fEncode
Tipo: System.Boolean
true para codificar o atributo e seu valor; Caso contrário, false.

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

Para uma instância de qualquer elemento de marcação indicada, o HtmlTextWriter classe mantém uma lista de atributos desse elemento. Quando o RenderBeginTag método é chamado, quaisquer atributos adicionados pelo AddAttribute são processados para a marca de abertura do elemento. A lista de atributos está desmarcada, em seguida, da HtmlTextWriter objeto.

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

O padrão de codificação para o processamento de elementos de marcação é o seguinte:

  • Use o AddAttribute método para adicionar quaisquer atributos ao elemento.

  • Use o método RenderBeginTag.

  • Use outros métodos conforme necessário para processar o conteúdo encontrado entre o elemento de abertura e marcas de fechamento.

  • Use o método RenderEndTag.

O exemplo de código a seguir demonstra como usar o AddAttribute(HtmlTextWriterAttribute, String, Boolean) método para garantir que o valor de seqüência de caracteres que é atribuído a uma Alt de atributo para um <img> elemento está codificado para o dispositivo solicitante.


// 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

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft