WebControl.Attributes (Propiedad) (System.Web.UI.WebControls)

Cambiar vista:
Sin script
Biblioteca de clases de .NET Framework
WebControl.Attributes (Propiedad)

Actualización: noviembre 2007

Obtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)
Sintaxis

Visual Basic (Declaración)
<BrowsableAttribute(False)> _
Public ReadOnly Property Attributes As AttributeCollection
Visual Basic (Uso)
Dim instance As WebControl
Dim value As AttributeCollection

value = instance.Attributes

C#
[BrowsableAttribute(false)]
public AttributeCollection Attributes { get; }
Visual C++
[BrowsableAttribute(false)]
public:
property AttributeCollection^ Attributes {
	AttributeCollection^ get ();
}
J#
/** @property */
/** @attribute BrowsableAttribute(false) */
public AttributeCollection get_Attributes()

JScript
public function get Attributes () : AttributeCollection

Valor de propiedad

Tipo: System.Web.UI.AttributeCollection
AttributeCollection de pares de nombre y valor.
Comentarios

La colección Attributes contiene una colección de todos los atributos declarados en la etiqueta de apertura de un control de servidor Web. Esto permite controlar mediante programación los atributos asociados a un control de servidor Web. Se puede agregar o quitar atributos a la colección.

wctwt6d4.alert_note(es-es,VS.90).gif Nota:

Esta propiedad es representada con todos los atributos de la colección en la etiqueta de apertura del control, independientemente de la configuración del explorador. No todos los exploradores admiten todos los atributos representados. Generalmente, el explorador omite los atributos no admitidos.

wctwt6d4.alert_note(es-es,VS.90).gif Nota:

No puede agregar una secuencia de comandos de cliente a una instancia de WebControl utilizando la colección Attributes. Para agregar una secuencia de comandos de cliente, utilice la propiedad ClientScript en el control Page.

Ejemplos

En el siguiente ejemplo se ilustra cómo se puede utilizar la propiedad Attributes de un WebControl para ejecutar un comando de JavaScript cuando el control TextBox pierde el foco.

wctwt6d4.alert_note(es-es,VS.90).gif Nota:

El siguiente ejemplo de código utiliza el modelo de código de un solo archivo y puede que no funcione correctamente si se copia directamente en un archivo de código subyacente. Se debe copiar este ejemplo de código en un archivo de texto vacío con la extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea Modelo de código de las páginas web ASP.NET.

wctwt6d4.alert_security(es-es,VS.90).gif Nota de seguridad:

Este ejemplo tiene un cuadro de texto que acepta datos del usuario y puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

Visual Basic

<%@ 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>



C#

<%@ 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>



JScript

<%@ Page Language="JScript" 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="JSCRIPT" runat="server">

        function Page_Load(sender : Object, e : EventArgs){
            TextBox1.Attributes("onblur") = "javascript:alert('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 tab out of this text box" 
     runat="server"/>  

 </form>
 </body>
 </html>



Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Información de versión

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
Vea también

Referencia

Otros recursos