WebControl.Attributes Property

Definition

Obtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

public:
 property System::Web::UI::AttributeCollection ^ Attributes { System::Web::UI::AttributeCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.AttributeCollection Attributes { get; }
member this.Attributes : System.Web.UI.AttributeCollection
Public ReadOnly Property Attributes As AttributeCollection

Property Value

AttributeCollection

AttributeCollection de pares de nombre y valor.A AttributeCollection of name and value pairs.

Attributes

Examples

En el ejemplo siguiente se muestra cómo se puede usar la propiedad Attributes de una WebControl para ejecutar un comando de JavaScript cuando el control de TextBox pierde el foco.The following example illustrates how the Attributes property of a WebControl can be used to run a JavaScript command when the TextBox control loses focus.

Note

En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Este ejemplo de código se debe copiar en un archivo de texto vacío que tenga una extensión. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Para obtener más información sobre el modelo de código de formularios Web Forms, vea modelo de código de la Página de formularios web forms ASP.net.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

Important

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.


<%@ Page Language="C#" AutoEventWireup="True" %>

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Attributes Property of a Web Control</title>
<script language="C#" runat="server">
 
        void Page_Load(Object sender, EventArgs e) {
           TextBox1.Attributes["onblur"]="javascript:alert('Hello! Focus lost from text box!!');";    
        }
    </script>
 
 </head>
 <body>
    <h3>Attributes Property of a Web Control</h3>
 <form id="form1" runat="server">
 
    <asp:TextBox id="TextBox1" columns="54" 
     Text="Click here and then tap out of this text box" 
     runat="server"/>  
 
 </form>
 </body>
 </html>
 

<%@ Page Language="VB" AutoEventWireup="True" %>

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Attributes Property of a Web Control</title>
<script language="VB" runat="server">
 
        Sub Page_Load(sender As Object, e As EventArgs)
            TextBox1.Attributes("onblur") = "javascript:alert('Hello! Focus lost from text box!!');"
        End Sub
    </script>
 
 </head>
 <body>
    <h3>Attributes Property of a Web Control</h3>
 <form id="form1" runat="server">
 
    <asp:TextBox id="TextBox1" columns="54" 
     Text="Click here and then tap out of this text box" 
     runat="server"/>  
 
 </form>
 </body>
 </html>
 

Remarks

La colección Attributes contiene una colección de todos los atributos declarados en la etiqueta de apertura de un control de servidor Web.The Attributes collection contains a collection of all attributes declared in the opening tag of a Web server control. Esto permite controlar mediante programación los atributos asociados a un control de servidor Web.This allows you to programmatically control the attributes associated with a Web server control. Puede agregar atributos a la colección o quitar atributos de la colección.You can add attributes to the collection or remove attributes from the collection.

Note

Esta propiedad se representa con todos los atributos de la colección en la etiqueta de apertura del control, independientemente de la configuración del explorador.This property is rendered with all attributes in the collection in the control's opening tag, regardless of the browser settings. No todos los exploradores admiten todos los atributos que se representan.Not all browsers support every attribute that is rendered. El explorador normalmente omite los atributos no compatibles.The unsupported attributes are usually ignored by the browser.

Note

No se puede Agregar un script del lado cliente a una instancia de WebControl mediante la colección Attributes.You cannot add client-side script to a WebControl instance using the Attributes collection. Para agregar un script del lado cliente, use la propiedad ClientScript en el control Page.To add client-side script, use the ClientScript property on the Page control.

Applies to

See also