WebControl.Attributes Proprietà

Definizione

Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo.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

Valore della proprietà

Insieme AttributeCollection di coppie di nomi e valori.A AttributeCollection of name and value pairs.

Attributi

Esempi

Nell'esempio seguente viene illustrato come è Attributes possibile utilizzare la WebControl proprietà di un oggetto per eseguire un comando JavaScript quando TextBox il controllo perde lo stato attivo.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

Nell'esempio di codice seguente viene utilizzato il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Questo esempio di codice deve essere copiato in un file di testo vuoto con estensione aspx.This code sample must be copied into an empty text file that has an .aspx extension. Per ulteriori informazioni sul modello di codice Web Form, vedere il modello di codice della pagina Web form ASP.NET.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.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>
 

Commenti

La Attributes raccolta contiene una raccolta di tutti gli attributi dichiarati nel tag di apertura di un controllo server Web.The Attributes collection contains a collection of all attributes declared in the opening tag of a Web server control. In questo modo è possibile controllare a livello di codice gli attributi associati a un controllo server Web.This allows you to programmatically control the attributes associated with a Web server control. È possibile aggiungere attributi alla raccolta oppure rimuovere gli attributi dalla raccolta.You can add attributes to the collection or remove attributes from the collection.

Nota

Questa proprietà viene sottoposta a rendering con tutti gli attributi nella raccolta nel tag di apertura del controllo, indipendentemente dalle impostazioni del browser.This property is rendered with all attributes in the collection in the control's opening tag, regardless of the browser settings. Non tutti i browser supportano tutti gli attributi di cui viene eseguito il rendering.Not all browsers support every attribute that is rendered. Gli attributi non supportati vengono in genere ignorati dal browser.The unsupported attributes are usually ignored by the browser.

Nota

Non è possibile aggiungere script sul lato client a WebControl un'istanza di Attributes utilizzando la raccolta.You cannot add client-side script to a WebControl instance using the Attributes collection. Per aggiungere uno script sul lato client, utilizzare ClientScript la proprietà Page nel controllo.To add client-side script, use the ClientScript property on the Page control.

Si applica a

Vedi anche