HtmlTextWriter.WriteAttribute Método
Definición
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.
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 -> unitPublic 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
altatributo 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" requiredy, a continuación, establece enfEncodefalse.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
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 -> unitPublic 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
altatributo 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" requiredy, a continuación, establece enfEncodefalse.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.
