HtmlTextWriter.WriteAttribute Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Escribe un atributo de marcado y su valor 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. |
WriteAttribute(String, String) |
Escribe el atributo de marcado y el valor especificados en el flujo de salida. |
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 deNo "encoding" required
y, a continuación, establece enfEncode
false
.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 "encoding" 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
.NET Framework 4.8.1 y otras versiones
Producto | Versiones |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
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 deNo "encoding" required
y, a continuación, establece enfEncode
false
.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 "encoding" 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
.NET Framework 4.8.1 y otras versiones
Producto | Versiones |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: