Partilhar via


HtmlTextWriter.WriteAttribute Método

Definição

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.

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value, bool fEncode);
public virtual void WriteAttribute (string name, string value, bool fEncode);
abstract member WriteAttribute : string * string * bool -> unit
override this.WriteAttribute : string * string * bool -> unit
Public Overridable Sub WriteAttribute (name As String, value As String, fEncode As Boolean)

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>

// 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" );
// 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");
' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

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

Aplica-se a

WriteAttribute(String, String)

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

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value);
public virtual void WriteAttribute (string name, string value);
abstract member WriteAttribute : string * string -> unit
override this.WriteAttribute : string * string -> unit
Public Overridable Sub WriteAttribute (name As String, value As String)

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>

// 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" );
// 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");
' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

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

Aplica-se a