AttributeCollection AttributeCollection AttributeCollection AttributeCollection Class

Definition

Ermöglicht im Objektmodell den Zugriff auf alle Attribute, die im öffnenden Tag eines ASP.NET-Serversteuerelements deklariert wurden.Provides object-model access to all attributes declared in the opening tag of an ASP.NET server control element. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class AttributeCollection sealed
public sealed class AttributeCollection
type AttributeCollection = class
Public NotInheritable Class AttributeCollection
Vererbung
AttributeCollectionAttributeCollectionAttributeCollectionAttributeCollection

Beispiele

Das folgende Beispiel erstellt ein neues AttributeCollection Objekt mit dem Namen myAttributeCollection, und klicken Sie dann überprüft, ob die Seite zurückgesendet wurde.The following example creates a new AttributeCollection object that is named myAttributeCollection, and then checks whether the page has been posted back. Wenn dies nicht der Fall ist, fügt der Code zwei Attribute der Auflistung hinzu.If it has not, the code adds two attributes to the collection. Anschließend ruft die Anzahl der Attribute in der Auflistung ab und durchläuft die Auflistung, die den Schlüssel für jedes Attribut auf der Seite schreiben.It then gets the number of attributes in the collection and iterates through the collection, writing the key to each attribute to the page. Wenn die Seite zurückgesendet wird, wird der Code Ruft die neue Anzahl von Attributen ab und durchläuft die Auflistung, die den Schlüssel und Wert der einzelnen Attribute auf der Seite schreiben.If the page is a postback, the code gets the new number of attributes and iterates through the collection, writing the key and value of each attribute to the page.

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

Zurückgeben der einzelnen Elemente in der Auflistung eine String Objekt als Wert.Individual items in the collection return a String object as their value. Wenn keine Attributelemente in der Auflistung vorhanden sind, gibt die Auflistung null.If there are no attribute items in the collection, the collection returns null.

Attribute auf ein HTML-Serversteuerelement sind programmgesteuert verfügbar, über die Attributes -Eigenschaft, die von der alle HTML-Serversteuerelemente geerbt wird.Attributes on an HTML server control are programmatically available through the Attributes property, which is inherited by all HTML server controls. ASP.NET stellt die Attribute des HTML-Serversteuerelemente als Eigenschaften dieser Steuerelemente.ASP.NET exposes attributes of HTML server controls as properties of those controls.

Sie können Attribute auf einem Webserver-Steuerelement durch Hinzufügen der Attributes -Eigenschaft, die von allen Webserver-Steuerelemente geerbt wird.You can add attributes to a Web server control through the Attributes property, which is inherited by all Web server controls. Die Attribute in der attributauflistung für einen Webserver-Steuerelement entsprechen nicht unbedingt um stark typisierte Eigenschaften für dieses Steuerelement des Steuerelements.The attributes in the attributes collection for a Web server control do not necessarily correspond to the control's strongly typed properties for that control.

Konstruktoren

AttributeCollection(StateBag) AttributeCollection(StateBag) AttributeCollection(StateBag) AttributeCollection(StateBag)

Initialisiert eine neue Instanz der AttributeCollection-Klasse.Initializes a new instance of the AttributeCollection class.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Attribute im AttributeCollection-Objekt ab.Gets the number of attributes in the AttributeCollection object.

CssStyle CssStyle CssStyle CssStyle

Ruft eine Auflistung von Formaten für das ASP.NET-Serversteuerelement ab, zu dem das aktuelle AttributeCollection-Objekt gehört.Gets a collection of styles for the ASP.NET server control to which the current AttributeCollection object belongs.

Item[String] Item[String] Item[String] Item[String]

Ruft einen angegebenen Attributwert für ein Serversteuerelement ab oder legt diesen fest.Gets or sets a specified attribute value for a server control.

Keys Keys Keys Keys

Ruft eine Auflistung mit den Schlüsseln für alle Attribute im AttributeCollection-Objekt des Serversteuerelements ab.Gets a collection of keys to all attributes in the server control's AttributeCollection object.

Methoden

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Fügt dem AttributeCollection-Objekt eines Serversteuerelements ein Attribut hinzu.Adds an attribute to a server control's AttributeCollection object.

AddAttributes(HtmlTextWriter) AddAttributes(HtmlTextWriter) AddAttributes(HtmlTextWriter) 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.Adds attributes from the AttributeCollection class to the HtmlTextWriter object that is responsible for rendering the attributes as markup.

Clear() Clear() Clear() Clear()

Entfernt alle Attribute aus dem AttributeCollection-Objekt eines Serversteuerelements.Removes all attributes from a server control's AttributeCollection object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob die aktuelle Instanz des AttributeCollection-Objekts gleich dem angegebenen Objekt ist.Determines whether the current instance of the AttributeCollection object is equal to the specified object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String) Remove(String) Remove(String) Remove(String)

Entfernt ein Attribut aus dem AttributeCollection-Objekt eines Serversteuerelements.Removes an attribute from a server control's AttributeCollection object.

Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

Schreibt die Auflistung der Attribute in den angegebenen HtmlTextWriter-Ausgabestream für das Steuerelement, zu dem die Auflistung gehört.Writes the collection of attributes to the specified HtmlTextWriter output stream for the control to which the collection belongs.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch