HtmlTextWriter.WriteAttribute Método

Definición

Escribe un atributo de marcado y su valor en el flujo de salida.

Sobrecargas

WriteAttribute(String, String, Boolean)

Escribe el atributo de marcado y el valor especificados en el flujo de salida y, si se especifica, escribe el valor codificado.

WriteAttribute(String, String)

Escribe el atributo de marcado y el valor especificados en el flujo de salida.

WriteAttribute(String, String, Boolean)

Escribe el atributo de marcado y el valor especificados en el flujo de salida y, si se especifica, escribe el 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

Atributo de marcado que se va a escribir en el flujo de salida.

value
String

Valor asignado al atributo.

fEncode
Boolean

true para codificar el atributo y su valor asignado; de lo contrario, false.

Ejemplos

En el ejemplo de código siguiente se muestra cómo representar un <img> elemento en el que se llama a ambas sobrecargas del WriteAttribute método. En el ejemplo de código se usa el siguiente proceso:

  • Llama al WriteBeginTag método , que representa los caracteres de apertura del elemento.

  • Llama a la WriteAttribute(String, String) sobrecarga, que escribe un alt atributo y su valor en el <img> elemento .

  • Llama a la WriteAttribute(String, String, Boolean) sobrecarga para representar un atributo personalizado myattribute , con un valor de No "encoding" requiredy, a continuación, establece en fEncodefalse.

  • Cierra la etiqueta de apertura del elemento y, a continuación, llama al WriteEndTag método para cerrar el <img> elemento.

Este ejemplo de código genera el marcado siguiente:

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

Comentarios

Use el WriteAttribute método para escribir atributos de marcado y sus valores con o sin codificación. El WriteAttribute método usa el HtmlAttributeEncode método para realizar la codificación.

El WriteAttribute método escribe el valor del atributo entre comillas dobles ("). Si value es null, el WriteAttribute método escribe solo el nombre del atributo.

Notas a los desarrolladores de herederos

En las clases derivadas, puede invalidar el WriteAttribute(String, String, Boolean) método para definir reglas personalizadas para escribir atributos y sus valores. Por ejemplo, podría escribir código que permitía al WriteAttribute(String, String, Boolean) método escribir un atributo con un valor vacío.

Consulte también

Se aplica a

WriteAttribute(String, String)

Escribe el atributo de marcado y el valor especificados en el flujo de salida.

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

Atributo que se va a escribir en el flujo de salida.

value
String

Valor asignado al atributo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo representar un <img> elemento en el que se llama a ambas sobrecargas del WriteAttribute método. En el ejemplo de código se usa el siguiente proceso:

  • Llama al WriteBeginTag método , que representa los caracteres de apertura del elemento.

  • Llama a la WriteAttribute(String, String) sobrecarga, que escribe un alt atributo y su valor en el <img> elemento .

  • Llama a la WriteAttribute(String, String, Boolean) sobrecarga para representar un atributo personalizado myattribute , con un valor de No "encoding" requiredy, a continuación, establece en fEncodefalse.

  • Cierra la etiqueta de apertura del elemento y, a continuación, llama al WriteEndTag método para cerrar el <img> elemento.

Este ejemplo de código genera el marcado siguiente:

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

Comentarios

Use el WriteAttribute método para escribir atributos de marcado y sus valores sin codificación. El WriteAttribute método escribe el valor del atributo entre comillas dobles ("). Si value es null, el WriteAttribute método escribe solo el nombre del atributo.

Notas a los desarrolladores de herederos

En las clases derivadas, puede invalidar el WriteAttribute(String, String) método para definir reglas personalizadas para escribir atributos y sus valores. Por ejemplo, podría escribir código que permitía al WriteAttribute(String, String) método escribir un atributo con un valor vacío.

Consulte también

Se aplica a