HtmlTextWriter.WriteAttribute Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Grava um atributo de marcação e seu valor no fluxo de saída.

Sobrecargas

WriteAttribute(String, String, Boolean)	Grava o atributo de marcação e o valor especificados no fluxo de saída e, se especificado, grava o valor codificado.
WriteAttribute(String, String)	Grava o atributo de marcação e o valor especificados no fluxo de saída.

WriteAttribute(String, String, Boolean)

Grava o atributo de marcação e o valor especificados no fluxo de saída e, se especificado, grava o valor codificado.

C#

public virtual void WriteAttribute (string name, string value, bool fEncode);

Parâmetros

name

String

O atributo de marcação a gravar no fluxo de saída.

value

String

O valor atribuído ao atributo.

fEncode

Boolean

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

Exemplos

O exemplo de código a seguir demonstra a renderização de um <img> elemento no qual ambas as sobrecargas do WriteAttribute método são chamadas. O exemplo de código usa o seguinte processo:

• Chama o WriteBeginTag método , que renderiza os caracteres de abertura do elemento .

• Chama a WriteAttribute(String, String) sobrecarga, que grava um alt atributo e seu valor no <img> elemento .

• Chama a WriteAttribute(String, String, Boolean) sobrecarga para renderizar um atributo personalizado myattribute , com um valor de No "encoding" requirede, em seguida, define fEncode como false.

• Fecha a marca de abertura do elemento e chama o WriteEndTag método para fechar o <img> elemento.

Este exemplo de código gera a seguinte marcação:

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

C#

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

Comentários

Use o WriteAttribute método para gravar atributos de marcação e seus valores com ou sem codificação. O WriteAttribute método usa o HtmlAttributeEncode método para fazer a codificação.

O WriteAttribute método grava o valor do atributo entre aspas duplas ("). Se value for null, o WriteAttribute método gravará apenas o nome do atributo.

Notas aos Herdeiros

Em classes derivadas, você pode substituir o WriteAttribute(String, String, Boolean) método para definir regras personalizadas para escrever atributos e seus valores. Por exemplo, você pode escrever um código que permitiu que o WriteAttribute(String, String, Boolean) método escrevesse um atributo com um valor vazio.

Confira também

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

WriteAttribute(String, String)

Grava o atributo de marcação e o valor especificados no fluxo de saída.

C#

public virtual void WriteAttribute (string name, string value);

Parâmetros

name

String

O atributo a ser gravado no fluxo de saída.

value

String

O valor atribuído ao atributo.

Exemplos

O exemplo de código a seguir demonstra a renderização de um <img> elemento no qual ambas as sobrecargas do WriteAttribute método são chamadas. O exemplo de código usa o seguinte processo:

• Chama o WriteBeginTag método , que renderiza os caracteres de abertura do elemento .

• Chama a WriteAttribute(String, String) sobrecarga, que grava um alt atributo e seu valor no <img> elemento .

• Chama a WriteAttribute(String, String, Boolean) sobrecarga para renderizar um atributo personalizado myattribute , com um valor de No "encoding" requirede, em seguida, define fEncode como false.

• Fecha a marca de abertura do elemento e chama o WriteEndTag método para fechar o <img> elemento.

Este exemplo de código gera a seguinte marcação:

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

C#

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

Comentários

Use o WriteAttribute método para gravar atributos de marcação e seus valores sem codificação. O WriteAttribute método grava o valor do atributo entre aspas duplas ("). Se value for null, o WriteAttribute método gravará apenas o nome do atributo.

Notas aos Herdeiros

Em classes derivadas, você pode substituir o WriteAttribute(String, String) método para definir regras personalizadas para escrever atributos e seus valores. Por exemplo, você pode escrever um código que permitiu que o WriteAttribute(String, String) método escrevesse um atributo com um valor vazio.

Confira também

• TextWriter