AttributeCollection Klasse

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Bietet Objektmodellzugriff auf alle Attribute, die im öffnenden Tag eines ASP.NET Serversteuerelementelements deklariert sind. 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 erstellt, das den Namen myAttributeCollectionhat, und überprüft dann, ob die Seite zurück gepostet wurde. Falls nicht, fügt der Code der Auflistung zwei Attribute hinzu.If it has not, the code adds two attributes to the collection. Anschließend ruft sie die Anzahl der Attribute in der Auflistung ab und durchläuft die Auflistung, und schreibt den Schlüssel zu jedem Attribut auf die Seite. Wenn es sich bei der Seite um ein Postback handelt, ruft der Code die neue Anzahl von Attributen ab und durchläuft die Auflistung, und schreibt den Schlüssel und wert jedes Attributs auf die Seite.

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, wird die Auflistung zurückgegeben 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 typierten Eigenschaften des Steuerelements für dieses Steuerelement.

Konstruktoren

Name	Beschreibung
AttributeCollection(StateBag)	Initialisiert eine neue Instanz der AttributeCollection-Klasse.

Eigenschaften

Name	Beschreibung
Count	Ruft die Anzahl der Attribute im AttributeCollection Objekt ab.
CssStyle	Ruft eine Auflistung von Formatvorlagen für das ASP.NET Serversteuerelement ab, zu dem das aktuelle AttributeCollection Objekt gehört.
Item[String]	Dient zum Abrufen oder Festlegen eines angegebenen Attributwerts für ein Serversteuerelement.
Keys	Ruft eine Auflistung von Schlüsseln für alle Attribute im Objekt des Serversteuerelements AttributeCollection ab.

Methoden

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

Weitere Informationen

• Attributes
• Attributes