AttributeCollection-Klasse

Ermöglicht im Objektmodell den Zugriff auf alle Attribute, die im öffnenden Tag eines ASP.NET-Serversteuerelements deklariert wurden. Diese Klasse kann nicht geerbt werden.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public NotInheritable Class AttributeCollection
'Usage
Dim instance As AttributeCollection

public sealed class AttributeCollection

public ref class AttributeCollection sealed

public final class AttributeCollection

public final class AttributeCollection

Hinweise

Die Groß- und Kleinschreibung von Attributen hängt davon ab, ob die StateBag-Klasse, von der geerbt wird, zwischen Groß- und Kleinschreibung unterscheidet. Sie geben ein String-Objekt als Wert zurück. Wenn in der Auflistung keine Attribute vorhanden sind, wird NULL (Nothing in Visual Basic) zurückgegeben.

Auf die Attribute eines HTML-Serversteuerelements kann mit der Attributes-Eigenschaft, die alle HTML-Serversteuerelemente erben, programmgesteuert zugegriffen werden. Die einem HTML-Serversteuerelement zugehörigen HTML-Attribute werden in .NET Framework als Eigenschaften des jeweiligen HTML-Serversteuerelements behandelt.

Sie können einem Webserversteuerelement Attribute auch über die Attributes-Eigenschaft hinzufügen, die alle Webserversteuerelemente erben. In dieser Auflistung gespeicherte Attribute für ein Webserversteuerelement entsprechen nicht den streng typisierten Eigenschaften des angegebenen Webserversteuerelements.

Thema	Position
Gewusst wie: Lesen von HTML-Attributen für Steuerelemente auf Web Forms-Seiten	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Lesen von HTML-Attributen für Steuerelemente auf Web Forms-Seiten	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Lesen von HTML-Attributen für Steuerelemente auf Web Forms-Seiten	Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Beispiel wird eine neue AttributeCollection mit der Bezeichnung myAttributeCollection erstellt und dann überprüft, ob die Seite zurückgesendet wurde. Wenn dies nicht der Fall ist, werden der Auflistung zwei Attribute hinzugefügt, anschließend wird die Anzahl der Attribute in der Auflistung abgerufen und die Auflistung durchlaufen, wobei der Schlüssel für jedes Attribut auf die Seite geschrieben wird. Wenn die Seite zurückgesendet wird, wird im Beispiel nur die neue Anzahl von Attributen abgerufen und die Auflistung durchlaufen, wobei der Schlüssel für jedes Attribut und sein Wert auf die Seite geschrieben werden.

        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

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++;
      }
   }
}

System.Web.UI.AttributeCollection myAttributeCollection = null;
      
void Page_Load(Object sender,EventArgs e)
{
    myAttributeCollection = 
        new System.Web.UI.AttributeCollection(get_ViewState());
    get_Response().
        Write("<h3> AttributeCollection.AttributeCollection Sample </h3>");
    if (!get_IsPostBack()) {  
        myAttributeCollection.Add("Color" ,"Color.Red");
        myAttributeCollection.Add("BackColor","Color.blue");
        get_Response().Write("Attribute Collection  count before PostBack = " 
            + myAttributeCollection.get_Count());
        get_Response().Write("<br><U><h4>Enumerating Attributes for "
            + "CustomControl before PostBack</h4></U>");
        IEnumerator keys = myAttributeCollection.get_Keys().GetEnumerator();
        int i =1;
        String key;
        while (keys.MoveNext()) {
            key = (String)keys.get_Current();
            get_Response().Write(i + ". " + key + "=" 
                + myAttributeCollection.get_Item (key) + "<br>");
            i++;
        }
    }
    else {
        get_Response().Write("Attribute Collection  count after PostBack = "
            + myAttributeCollection.get_Count());
        get_Response().Write("<br><U><h4>Enumerating Attributes for "
            + "CustomControl after PostBack</h4></U>");
        IEnumerator keys = myAttributeCollection.get_Keys().GetEnumerator();
        int i =1;
        String key;
        while (keys.MoveNext()) {
            key = (String)keys.get_Current();
            get_Response().Write(i + ". " + key + "=" 
                + myAttributeCollection.get_Item(key)+"<br>");
            i++;
        }
    }
} //Page_Load

.NET Framework-Sicherheit

• AspNetHostingPermission  für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal.

Vererbungshierarchie

System.Object
  System.Web.UI.AttributeCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

AttributeCollection-Member
System.Web.UI-Namespace
Attributes
Attributes