HtmlTextWriter.AddAttribute 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í.
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 -> unitPublic 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
Se aplica a
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 -> unitPublic Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)Parámetros
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
Se aplica a
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 -> unitPublic 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)
Se aplica a
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 -> unitProtected 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.
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
Se aplica a
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 -> unitPublic Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)Parámetros
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)
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de