AttributeCollection AttributeCollection AttributeCollection AttributeCollection Class

Definition

Stellt eine Auflistung von Attributen dar.Represents a collection of attributes.

public ref class AttributeCollection : System::Collections::ICollection
[System.Runtime.InteropServices.ComVisible(true)]
public class AttributeCollection : System.Collections.ICollection
type AttributeCollection = class
    interface ICollection
    interface IEnumerable
Public Class AttributeCollection
Implements ICollection
Vererbung
AttributeCollectionAttributeCollectionAttributeCollectionAttributeCollection
Attribute
Implementiert

Beispiele

Im ersten Codebeispiel wird überprüft, ob die BrowsableAttribute in dieser Sammlung festgelegt wurde.The first code example checks to see whether the BrowsableAttribute has been set in this collection. Im zweite Codebeispiel wird der tatsächliche Wert von der DescriptionAttribute für eine Schaltfläche.The second code example gets the actual value of the DescriptionAttribute for a button. Beide Beispiele ist es erforderlich, die button1 und textBox1 in einem Formular erstellt wurden.Both examples require that button1 and textBox1 have been created on a form. Wenn Sie Attribute verwenden, stellen Sie sicher, dass ein Attribut festgelegt wurde, oder den Zugriff auf dessen Wert.When using attributes, verify that an attribute has been set, or access its value.

private:
   void ContainsAttribute()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ attributes;
      attributes = TypeDescriptor::GetAttributes( button1 );
      
      // Sets an Attribute to the specific attribute.
      BrowsableAttribute^ myAttribute = BrowsableAttribute::Yes;

      if ( attributes->Contains( myAttribute ) )
      {
         textBox1->Text = "button1 has a browsable attribute.";
      }
      else
      {
         textBox1->Text = "button1 does not have a browsable attribute.";
      }
   }
private void ContainsAttribute() {
    // Creates a new collection and assigns it the attributes for button1.
    AttributeCollection attributes;
    attributes = TypeDescriptor.GetAttributes(button1);
 
    // Sets an Attribute to the specific attribute.
    BrowsableAttribute myAttribute = BrowsableAttribute.Yes;
 
    if (attributes.Contains(myAttribute))
       textBox1.Text = "button1 has a browsable attribute.";
    else
       textBox1.Text = "button1 does not have a browsable attribute.";
 }
Private Sub ContainsAttribute()
    ' Creates a new collection and assigns it the attributes for button1.
    Dim attributes As AttributeCollection
    attributes = TypeDescriptor.GetAttributes(button1)
    
    ' Sets an Attribute to the specific attribute.
    Dim myAttribute As BrowsableAttribute = BrowsableAttribute.Yes
    
    If attributes.Contains(myAttribute) Then
        textBox1.Text = "button1 has a browsable attribute."
    Else
        textBox1.Text = "button1 does not have a browsable attribute."
    End If
End Sub 'ContainsAttribute
private:
   void GetAttributeValue()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ attributes;
      attributes = TypeDescriptor::GetAttributes( button1 );
      
      // Gets the designer attribute from the collection.
      DesignerAttribute^ myDesigner;
      myDesigner = (DesignerAttribute^)(attributes[DesignerAttribute::typeid]);
      
      // Prints the value of the attribute in a text box.
      textBox1->Text = myDesigner->DesignerTypeName;
   }
private void GetAttributeValue() {
    // Creates a new collection and assigns it the attributes for button1.
    AttributeCollection attributes;
    attributes = TypeDescriptor.GetAttributes(button1);
 
    // Gets the designer attribute from the collection.
    DesignerAttribute myDesigner; 
    myDesigner = (DesignerAttribute)attributes[typeof(DesignerAttribute)];
 
    // Prints the value of the attribute in a text box.
    textBox1.Text = myDesigner.DesignerTypeName;
 }
Private Sub GetAttributeValue()
    ' Creates a new collection and assigns it the attributes for button1.
    Dim attributes As AttributeCollection
    attributes = TypeDescriptor.GetAttributes(button1)
    
    ' Gets the designer attribute from the collection.
    Dim myDesigner As DesignerAttribute
    myDesigner = CType(attributes(GetType(DesignerAttribute)), DesignerAttribute)
    
    ' Prints the value of the attribute in a text box.
    textBox1.Text = myDesigner.DesignerTypeName
End Sub 'GetAttributeValue

Hinweise

Die AttributeCollection Klasse schreibgeschützt ist, sie Methoden zum Hinzufügen oder Entfernen von Attributen nicht implementiert.The AttributeCollection class is read-only; it does not implement methods to add or remove attributes. Sie müssen von dieser Klasse zur Implementierung dieser Methoden erben.You must inherit from this class to implement these methods.

Verwenden der Count Eigenschaft, die Anzahl der Attribute, die vorhanden sind in der Auflistung gesucht werden.Use the Count property to find the number of attributes that exist in the collection.

Sie können auch die Methoden dieser Klasse verwenden, um den Inhalt der Auflistung abzufragen.You can also use the methods of this class to query the collection about its contents. Rufen Sie die Contains Methode, um sicherzustellen, dass es sich bei einem angegebenen Attribut oder Attributarray in der Auflistung vorhanden ist.Call the Contains method to verify that a specified attribute or attribute array exists in the collection. Rufen Sie die Matches Methode, um zu überprüfen, ob ein angegebenes Attribut oder ein Array von Attributen in der Auflistung vorhanden ist, und die Werte der angegebenen Attribute der Werte in der Auflistung identisch sind.Call the Matches method to verify that a specified attribute or array of attributes exists in the collection, and that the values of the specified attributes are the same as the values in the collection.

Während die meisten Attribute auf Standardwerte festgelegt wurden, sind die Standardwerte nicht erforderlich.While most attributes have default values, default values are not required. Wenn ein Attribut, kein Standardwert zugewiesen wurde, hat null wird zurückgegeben, aus der indizierten Eigenschaft, die ein Typ verwendet wird.If an attribute has no default value, null is returned from the indexed property that takes a type. Beim Definieren Ihrer eigenen Attribute können Sie einen Standardwert deklarieren, indem Sie entweder einen Konstruktor bereitstellen, der keine Argumente akzeptiert oder öffentliches statisches Feld des Typs mit dem Namen "Default"-Attribut definieren.When defining your own attributes, you can declare a default value by either providing a constructor that takes no arguments, or defining a public static field of your attribute type named "Default".

Konstruktoren

AttributeCollection() AttributeCollection() AttributeCollection() AttributeCollection()

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

AttributeCollection(Attribute[]) AttributeCollection(Attribute[]) AttributeCollection(Attribute[]) AttributeCollection(Attribute[])

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

Felder

Empty Empty Empty Empty

Gibt eine leere Auflistung an, die Sie verwenden können, um so keine neue Auflistung erstellen zu müssen.Specifies an empty collection that you can use, rather than creating a new one. Dieses Feld ist schreibgeschützt.This field is read-only.

Eigenschaften

Attributes Attributes Attributes Attributes

Ruft die Attributauflistung ab.Gets the attribute collection.

Count Count Count Count

Ruft die Anzahl der Attribute ab.Gets the number of attributes.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft das Attribut mit der angegebenen Indexnummer ab.Gets the attribute with the specified index number.

Item[Type] Item[Type] Item[Type] Item[Type]

Ruft das Attribut mit dem angegebenen Typ ab.Gets the attribute with the specified type.

Methoden

Contains(Attribute) Contains(Attribute) Contains(Attribute) Contains(Attribute)

Bestimmt, ob das angegebene Attribut in dieser Auflistung von Attributen enthalten ist.Determines whether this collection of attributes has the specified attribute.

Contains(Attribute[]) Contains(Attribute[]) Contains(Attribute[]) Contains(Attribute[])

Bestimmt, ob diese Auflistung von Attributen sämtliche angegebenen Attribute im Attributarray enthält.Determines whether this attribute collection contains all the specified attributes in the attribute array.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Kopiert die Auflistung in ein Array, wobei am angegebenen Index begonnen wird.Copies the collection to an array, starting at the specified index.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FromExisting(AttributeCollection, Attribute[]) FromExisting(AttributeCollection, Attribute[]) FromExisting(AttributeCollection, Attribute[]) FromExisting(AttributeCollection, Attribute[])

Erstellt eine neue AttributeCollection-Klasse aus einer vorhandenen AttributeCollection-Klasse.Creates a new AttributeCollection from an existing AttributeCollection.

GetDefaultAttribute(Type) GetDefaultAttribute(Type) GetDefaultAttribute(Type) GetDefaultAttribute(Type)

Gibt die Attribute-Standardklasse einer bestimmten Type-Klasse zurück.Returns the default Attribute of a given Type.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Ruft einen Enumerator für diese Auflistung ab.Gets an enumerator for this collection.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
Matches(Attribute) Matches(Attribute) Matches(Attribute) Matches(Attribute)

Bestimmt, ob ein angegebenes Attribut mit einem Attribut in der Auflistung identisch ist.Determines whether a specified attribute is the same as an attribute in the collection.

Matches(Attribute[]) Matches(Attribute[]) Matches(Attribute[]) Matches(Attribute[])

Bestimmt, ob die Attribute im angegebenen Array mit den Attributen in der Auflistung identisch sind.Determines whether the attributes in the specified array are the same as the attributes in the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
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)

Explizite Schnittstellenimplementierungen

ICollection.Count ICollection.Count ICollection.Count ICollection.Count

Ruft die Anzahl der Elemente in der Auflistung ab.Gets the number of elements contained in the collection.

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert (threadsicher) ist.Gets a value indicating whether access to the collection is synchronized (thread-safe).

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die Auflistung synchronisiert werden kann.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Gibt einen IEnumerator für das IDictionary zurück.Returns an IEnumerator for the IDictionary.

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert eine IEnumerable auf eine IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch