AttributeCollection Klasse

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

Vererbung: Object
AttributeCollection

Beispiele

Im folgenden Beispiel wird ein neues AttributeCollection Objekt mit dem Namen erstellt myAttributeCollectionund dann überprüft, ob die Seite zurückgeschrieben wurde. Andernfalls fügt der Code der Auflistung zwei Attribute hinzu. Anschließend wird die Anzahl der Attribute in der Auflistung abgerufen und die Auflistung durchlaufen, wobei der Schlüssel in jedes Attribut der Seite geschrieben wird. Wenn es sich bei der Seite um ein Postback handelt, ruft der Code die neue Anzahl von Attributen ab und durchläuft die Auflistung, wobei der Schlüssel und der Wert jedes Attributs in die Seite geschrieben werden.

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

Hinweise

Einzelne Elemente in der Auflistung geben ein String Objekt als Wert zurück. Wenn keine Attributelemente in der Auflistung vorhanden sind, gibt die Auflistung zurück null.

Attribute für ein HTML-Serversteuerelement sind programmgesteuert über die Attributes Eigenschaft verfügbar, die von allen HTML-Serversteuerelementen geerbt wird. ASP.NET macht Attribute von HTML-Serversteuerelementen als Eigenschaften dieser Steuerelemente verfügbar.

Sie können einem Webserversteuerelement Attribute über die Attributes Eigenschaft hinzufügen, die von allen Webserversteuerelementen geerbt wird. Die Attribute in der Attributauflistung für ein Webserversteuerelement entsprechen nicht unbedingt den stark typisierten Eigenschaften des Steuerelements für dieses Steuerelement.

Konstruktoren

AttributeCollection(StateBag)

Initialisiert eine neue Instanz der AttributeCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Attribute im AttributeCollection-Objekt ab.
CssStyle	Ruft eine Auflistung von Formaten für das ASP.NET-Serversteuerelement ab, zu dem das aktuelle AttributeCollection-Objekt gehört.
Item[String]	Ruft einen angegebenen Attributwert für ein Serversteuerelement ab oder legt diesen fest.
Keys	Ruft eine Auflistung mit den Schlüsseln für alle Attribute im AttributeCollection-Objekt des Serversteuerelements ab.

Methoden

Add(String, String)	Fügt dem AttributeCollection-Objekt eines Serversteuerelements ein Attribut hinzu.
AddAttributes(HtmlTextWriter)	Fügt Attribute aus der AttributeCollection-Klasse dem HtmlTextWriter-Objekt hinzu, das für das Rendern der Attribute als Markup zuständig ist.
Clear()	Entfernt alle Attribute aus dem AttributeCollection-Objekt eines Serversteuerelements.
Equals(Object)	Bestimmt, ob die aktuelle Instanz des AttributeCollection-Objekts gleich dem angegebenen Objekt ist.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(String)	Entfernt ein Attribut aus dem AttributeCollection-Objekt eines Serversteuerelements.
Render(HtmlTextWriter)	Schreibt die Auflistung der Attribute in den angegebenen HtmlTextWriter-Ausgabestream für das Steuerelement, zu dem die Auflistung gehört.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Freigeben über