HtmlTextWriter.AddAttribute Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Agrega el valor y el atributo de marcado especificados a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag.

Sobrecargas

AddAttribute(String, String)	Agrega el valor y el atributo de marcado especificados a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag.
AddAttribute(HtmlTextWriterAttribute, String)	Agrega el atributo de marcado y el valor del atributo a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag.
AddAttribute(String, String, Boolean)	Agrega el valor y el atributo de marcado especificados a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag, con codificación opcional.
AddAttribute(String, String, HtmlTextWriterAttribute)	Agrega el valor y el atributo de marcado especificados, junto con un valor de la enumeración HtmlTextWriterAttribute, a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Agrega el atributo de marcado y el valor del atributo a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag, con codificación opcional.

AddAttribute(String, String)

Agrega el valor y el atributo de marcado especificados a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);

public virtual void AddAttribute (string name, string value);

abstract member AddAttribute : string * string -> unit
override this.AddAttribute : string * string -> unit

Public Overridable Sub AddAttribute (name As String, value As String)

Parámetros

name

String

Cadena con el nombre del atributo que se ha de agregar.

value

String

Cadena con el valor que se ha de asignar al atributo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar al AddAttribute método antes de llamar al RenderBeginTag método . El código llama a dos sobrecargas diferentes de AddAttribute y dos sobrecargas diferentes de antes de AddStyleAttribute llamar al RenderBeginTag método para representar un <span> elemento en el flujo de salida. El AddAttribute(String, String) método se usa para definir el atributo personalizado denominado CustomAttribute y el valor personalizado denominado CustomAttributeValue para el <span> elemento que representa este código.

// Set attributes and values along with attributes and styles  
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the 
// <span> element.
writer.WriteLine();
writer.Indent++;

' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)

'  Create a space and indent the markup inside the 
' <span> element.
writer.WriteLine()
writer.Indent += 1

Comentarios

Use la AddAttribute sobrecarga del AddAttribute(String, String) método si el atributo no es uno de los HtmlTextWriterAttribute valores, o si el atributo no se conoce hasta el tiempo de ejecución.

Para una instancia de cualquier elemento de marcado determinado, la HtmlTextWriter clase mantiene una lista de atributos para ese elemento. Cuando se llama al RenderBeginTag método , los atributos agregados por el AddAttribute método se representan en la etiqueta de apertura del elemento. A continuación, la lista de atributos se borra del HtmlTextWriter objeto .

El patrón de codificación para representar elementos de marcado es el siguiente:

• Use el AddAttribute método para agregar cualquier atributo al elemento .

• Utilice el método RenderBeginTag.

• Use otros métodos según sea necesario para representar el contenido encontrado entre las etiquetas de apertura y cierre del elemento.

• Utilice el método RenderEndTag.

Consulte también

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

AddAttribute(HtmlTextWriterAttribute, String)

Agrega el atributo de marcado y el valor del atributo a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);

public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

Parámetros

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute que representa el atributo de marcado que se va a agregar al flujo de salida.

value

String

Cadena con el valor que se ha de asignar al atributo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la AddAttribute sobrecarga del AddAttribute(HtmlTextWriterAttribute, String) método para agregar un Onclick atributo a un elemento de marcado y, a continuación, establecer su valor en el siguiente código ECMAScript:

alert('Hello');  

writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

Comentarios

Use la AddAttribute sobrecarga del AddAttribute(HtmlTextWriterAttribute, String) método para representar un atributo de marcado estándar.

Para una instancia de cualquier elemento de marcado determinado, la HtmlTextWriter clase mantiene una lista de atributos para ese elemento. Cuando se llama al RenderBeginTag método , los atributos agregados por el AddAttribute método se representan en la etiqueta de apertura del elemento. A continuación, la lista de atributos se borra de .HtmlTextWriter

El patrón de codificación para representar elementos de marcado es el siguiente:

• Use el AddAttribute método para agregar cualquier atributo al elemento .

• Utilice el método RenderBeginTag.

• Use otros métodos según sea necesario para representar el contenido encontrado entre las etiquetas de apertura y cierre del elemento.

• Utilice el método RenderEndTag.

Consulte también

• TextWriter
• RenderBeginTag
• RenderEndTag()

AddAttribute(String, String, Boolean)

Agrega el valor y el atributo de marcado especificados a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag, con codificación opcional.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);

public virtual void AddAttribute (string name, string value, bool fEndode);

abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit

Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

Parámetros

name

String

Cadena con el nombre del atributo que se ha de agregar.

value

String

Cadena con el valor que se ha de asignar al atributo.

fEndode

Boolean

true para codificar el atributo y su valor; en caso contrario, false.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la AddAttribute sobrecarga del método para asegurarse de AddAttribute(String, String, Boolean) que un atributo personalizado, denominado myattributey su valor no están codificados para un <img> elemento.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Comentarios

Use la AddAttribute sobrecarga del AddAttribute(String, String, Boolean) método si el atributo no es uno de los HtmlTextWriterAttribute valores, o si el atributo no se conoce hasta que se necesite tiempo de ejecución y codificación.

Para una instancia de cualquier elemento de marcado determinado, la HtmlTextWriter clase mantiene una lista de atributos para ese elemento. Cuando se llama al RenderBeginTag método , los atributos agregados por el AddAttribute método se representan en la etiqueta de apertura del elemento. A continuación, la lista de atributos se borra del HtmlTextWriter objeto .

Use el AddAttribute(String, String, Boolean) método con fEncode establecido en true, si el atributo puede contener una comilla ("), un signo menor que (<) o una y comercial (&). La llamada al método codificará el atributo para cumplir los requisitos del dispositivo solicitante. Puede establecer en fEncodefalse, si sabe que no se generará ninguno de estos caracteres o si sabe que el atributo ya está codificado.

Si el tipo de atributo es Style, el valor no se codificará aunque fEndode sea true. Asegúrese de que el valor de estilo es compatible con CSS y no contiene código malintencionado.

El patrón de codificación para representar elementos de marcado es el siguiente:

• Use el AddAttribute método para agregar cualquier atributo al elemento .

• Utilice el método RenderBeginTag.

• Use otros métodos según sea necesario para representar el contenido encontrado entre las etiquetas de apertura y cierre del elemento.

• Utilice el método RenderEndTag.

Consulte también

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)

AddAttribute(String, String, HtmlTextWriterAttribute)

Agrega el valor y el atributo de marcado especificados, junto con un valor de la enumeración HtmlTextWriterAttribute, a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag.

protected:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected virtual void AddAttribute (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit

Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

Parámetros

name

String

Cadena con el nombre del atributo que se ha de agregar.

value

String

Cadena con el valor que se ha de asignar al atributo.

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute que representa el atributo.

Comentarios

Use la AddAttribute sobrecarga del AddAttribute(String, String, HtmlTextWriterAttribute) método solo al heredar de la HtmlTextWriter clase . Permite crear pares y key nuevos name para atributos.

Consulte también

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Agrega el atributo de marcado y el valor del atributo a la etiqueta de apertura del elemento que crea el objeto HtmlTextWriter con una llamada posterior al método RenderBeginTag, con codificación opcional.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);

public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

Parámetros

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute que representa el atributo de marcado que se va a agregar al flujo de salida.

value

String

Cadena con el valor que se ha de asignar al atributo.

fEncode

Boolean

true para codificar el atributo y su valor; en caso contrario, false.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el AddAttribute(HtmlTextWriterAttribute, String, Boolean) método para asegurarse de que el valor de cadena asignado a un atributo de un Alt<img> elemento está codificado para el dispositivo solicitante.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Comentarios

Use la AddAttribute sobrecarga del AddAttribute(HtmlTextWriterAttribute, String, Boolean) método para representar un atributo de marcado estándar, con codificación opcional.

Para una instancia de cualquier elemento de marcado determinado, la HtmlTextWriter clase mantiene una lista de atributos para ese elemento. Cuando se llama al RenderBeginTag método , los atributos agregados por AddAttribute se representan en la etiqueta de apertura del elemento . A continuación, la lista de atributos se borra del HtmlTextWriter objeto .

Use el AddAttribute(HtmlTextWriterAttribute, String, Boolean) método con fEncode establecido en true, si el atributo puede contener una comilla ("), un signo menor que (<) o una y comercial (&). La llamada al método codificará el atributo para cumplir los requisitos del dispositivo solicitante. Puede establecer en fEncodefalse, si sabe que no se generará ninguno de estos caracteres o si sabe que el atributo ya está codificado.

Si el tipo de atributo es Style, el valor no se codificará aunque fEncode sea true. Asegúrese de que el valor de estilo es compatible con CSS y no contiene código malintencionado.

El patrón de codificación para representar elementos de marcado es el siguiente:

• Use el AddAttribute método para agregar cualquier atributo al elemento .

• Utilice el método RenderBeginTag.

• Use otros métodos según sea necesario para representar el contenido encontrado entre las etiquetas de apertura y cierre del elemento.

• Utilice el método RenderEndTag.

Consulte también

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)