HtmlTextWriter.WriteAttribute Método

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

Exemplos

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

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

• Chama o WriteAttribute(String, String) overload, que escreve um alt atributo e o seu valor ao <img> elemento.

• Chama o WriteAttribute(String, String, Boolean) overload para renderizar um atributo personalizado myattribute , com o valor de No "encoding" required, e depois define fEncode para false.

• Fecha a etiqueta de abertura do elemento e depois 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)

Observações

Use o WriteAttribute método para escrever atributos de marcação e os 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 escreve o valor do atributo incluído entre aspas duplas ("). Se value for null, o WriteAttribute método escreve apenas o nome do atributo.

Notas para Herdeiros

Nas classes derivadas, podes sobrescrever o WriteAttribute(String, String, Boolean) método para definir regras personalizadas para escrever atributos e os seus valores. Por exemplo, poderia escrever código que permitisse ao WriteAttribute(String, String, Boolean) método escrever um atributo com um valor vazio.

Ver também

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

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

Exemplos

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

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

• Chama o WriteAttribute(String, String) overload, que escreve um alt atributo e o seu valor ao <img> elemento.

• Chama o WriteAttribute(String, String, Boolean) overload para renderizar um atributo personalizado myattribute , com o valor de No "encoding" required, e depois define fEncode para false.

• Fecha a etiqueta de abertura do elemento e depois 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)

Observações

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

Notas para Herdeiros

Nas classes derivadas, podes sobrescrever o WriteAttribute(String, String) método para definir regras personalizadas para escrever atributos e os seus valores. Por exemplo, poderia escrever código que permitisse ao WriteAttribute(String, String) método escrever um atributo com um valor vazio.

Ver também

• TextWriter