WebControl.Attributes WebControl.Attributes WebControl.Attributes WebControl.Attributes Property

Definición

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

Valor de propiedad

Ejemplos

En el ejemplo siguiente se muestra cómo Attributes se puede usar WebControl la propiedad de una para ejecutar un comando de JavaScript TextBox cuando el control 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.

Nota

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.

Importante

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>
 

Comentarios

La Attributes colección 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.

Nota

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.

Nota

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

Se aplica a

Consulte también: