AttributeCollection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce accesso al modello di oggetti a tutti gli attributi dichiarati nel tag di apertura di un elemento di controllo del server ASP.NET. La classe non può essere ereditata.

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

Ereditarietà: Object
AttributeCollection

Esempio

Nell'esempio seguente viene creato un nuovo AttributeCollection oggetto denominato myAttributeCollectione quindi viene verificato se la pagina è stata pubblicata. In caso contrario, il codice aggiunge due attributi alla raccolta. Ottiene quindi il numero di attributi nella raccolta e scorre l'insieme, scrivendo la chiave in ogni attributo nella pagina. Se la pagina è un postback, il codice ottiene il nuovo numero di attributi e scorre l'insieme, scrivendo la chiave e il valore di ogni attributo nella pagina.

AttributeCollection myAttributeCollection = null;

void Page_Load(object sender,EventArgs e)
{
   myAttributeCollection = new AttributeCollection(ViewState);
   Response.Write("<h3> AttributeCollection.AttributeCollection Sample </h3>");
   if (!IsPostBack)
   {  
      myAttributeCollection.Add("Color" ,"Color.Red");
      myAttributeCollection.Add("BackColor","Color.blue");
      Response.Write("Attribute Collection  count before PostBack = " + myAttributeCollection.Count);
      Response.Write("<br /><u><h4>Enumerating Attributes for CustomControl before PostBack</h4></u>");
      IEnumerator keys = myAttributeCollection.Keys.GetEnumerator();
      int i =1;
      String key;
      while (keys.MoveNext())
      {
         key = (String)keys.Current;
         Response.Write(i + ". "+key + "=" + myAttributeCollection[key]+"<br />");
         i++;
      }
   }
   else
   {
      Response.Write("Attribute Collection  count after PostBack = "+myAttributeCollection.Count);
      Response.Write("<br /><u><h4>Enumerating Attributes for CustomControl after PostBack</h4></u>");
      IEnumerator keys = myAttributeCollection.Keys.GetEnumerator();
      int i =1;
      String key;
      while (keys.MoveNext())
      {
         key = (String)keys.Current;
         Response.Write(i + ". "+key + "=" + myAttributeCollection[key]+"<br />");
         i++;
      }
   }
}

  Dim myAttributeCollection As AttributeCollection = Nothing 

  Sub Page_Load(sender As Object, e As EventArgs)
      myAttributeCollection = New AttributeCollection(ViewState)
      Response.Write("<h3> AttributeCollection.AttributeCollection Sample </h3>")
      If Not IsPostBack Then
         myAttributeCollection.Add("Color", "Color.Red")
         myAttributeCollection.Add("BackColor", "Color.blue")
         Response.Write("Attribute Collection count before PostBack = " & _
myAttributeCollection.Count.ToString())
         Response.Write("<br /><u><h4>Enumerating Attributes for " & _
                                 "CustomControl before PostBack</h4></u>")
         Dim keys As IEnumerator = myAttributeCollection.Keys.GetEnumerator()
         Dim i As Integer = 1
         Dim key As String
         While keys.MoveNext()
            key = CType(keys.Current, String)
            Response.Write(i.ToString() + ". " + key + "=" + myAttributeCollection(key) + "<br />")
            i += 1
         End While
      Else
         Response.Write("Attribute Collection  count after PostBack = " + _
                                    myAttributeCollection.Count.ToString())
         Response.Write("<br /><u><h4>Enumerating Attributes for " + _
                                 "CustomControl after PostBack</h4></u>")
         Dim keys As IEnumerator = myAttributeCollection.Keys.GetEnumerator()
         Dim i As Integer = 1
         Dim key As String
         While keys.MoveNext()
            key = CType(keys.Current, String)
            Response.Write(i.ToString() + ". " + key + "=" + myAttributeCollection(key) + "<br />")
            i += 1
         End While
      End If
   End Sub

Commenti

I singoli elementi della raccolta restituiscono un String oggetto come valore. Se non sono presenti elementi di attributo nella raccolta, l'insieme restituisce null.

Gli attributi in un controllo server HTML sono disponibili a livello di codice tramite la Attributes proprietà , ereditata da tutti i controlli server HTML. ASP.NET espone gli attributi dei controlli server HTML come proprietà di tali controlli.

È possibile aggiungere attributi a un controllo server Web tramite la Attributes proprietà , ereditata da tutti i controlli server Web. Gli attributi nella raccolta di attributi per un controllo server Web non corrispondono necessariamente alle proprietà fortemente tipizzate del controllo per tale controllo.

Costruttori

AttributeCollection(StateBag)

Inizializza una nuova istanza della classe AttributeCollection.

Proprietà

Count	Ottiene il numero di attributi nell'oggetto AttributeCollection.
CssStyle	Ottiene un insieme di stili per il controllo server ASP.NET a cui appartiene l'oggetto AttributeCollection corrente.
Item[String]	Ottiene o imposta un valore di attributo specificato per un controllo server.
Keys	Ottiene un insieme di chiavi per tutti gli attributi nell'oggetto AttributeCollection del controllo server.

Metodi

Add(String, String)	Aggiunge un attributo a un oggetto AttributeCollection del controllo server.
AddAttributes(HtmlTextWriter)	Aggiunge gli attributi dalla classe AttributeCollection all'oggetto HtmlTextWriter responsabile del rendering degli attributi come markup.
Clear()	Rimuove tutti gli attributi da un oggetto AttributeCollection del controllo server.
Equals(Object)	Determina se l'istanza corrente dell'oggetto AttributeCollection è uguale all'oggetto specificato.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Restituisce il codice hash per l'istanza.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(String)	Rimuove un attributo da un oggetto AttributeCollection del controllo server.
Render(HtmlTextWriter)	Scrive l'insieme di attributi nel flusso di output dell'oggetto HtmlTextWriter specificato per il controllo al quale appartiene l'insieme.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a