AttributeCollection Klasse

Definition

public ref class AttributeCollection : System::Collections::ICollection

public class AttributeCollection : System.Collections.ICollection

[System.Runtime.InteropServices.ComVisible(true)]
public class AttributeCollection : System.Collections.ICollection

type AttributeCollection = class
    interface ICollection
    interface IEnumerable

[<System.Runtime.InteropServices.ComVisible(true)>]
type AttributeCollection = class
    interface ICollection
    interface IEnumerable

Public Class AttributeCollection
Implements ICollection

Vererbung

Object

AttributeCollection

Attribute

ComVisibleAttribute

Implementiert

ICollection IEnumerable

Beispiele

Im ersten Codebeispiel wird überprüft, ob in BrowsableAttribute dieser Auflistung festgelegt wurde. Im zweiten Codebeispiel wird der tatsächliche Wert von DescriptionAttribute für eine Schaltfläche abgerufen. Beide Beispiele erfordern, dass button1 und textBox1 auf einem Formular erstellt wurden. Wenn Sie Attribute verwenden, überprüfen Sie, ob ein Attribut festgelegt wurde, oder greifen Sie auf dessen Wert zu.

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

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

Hinweise

Die AttributeCollection -Klasse ist schreibgeschützt. Sie implementiert keine Methoden zum Hinzufügen oder Entfernen von Attributen. Sie müssen von dieser Klasse erben, um diese Methoden zu implementieren.

Verwenden Sie die Count -Eigenschaft, um die Anzahl der Attribute zu ermitteln, die in der Auflistung vorhanden sind.

Sie können auch die Methoden dieser Klasse verwenden, um den Inhalt der Auflistung abzufragen. Rufen Sie die Contains -Methode auf, um zu überprüfen, ob ein angegebenes Attribut oder Attributarray in der Auflistung vorhanden ist. Rufen Sie die Matches -Methode auf, um zu überprüfen, ob ein angegebenes Attribut oder Array von Attributen in der Auflistung vorhanden ist und dass die Werte der angegebenen Attribute mit den Werten in der Auflistung übereinstimmen.

Obwohl die meisten Attribute Standardwerte aufweisen, sind keine Standardwerte erforderlich. Wenn ein Attribut keinen Standardwert aufweist, null wird von der indizierten Eigenschaft zurückgegeben, die einen Typ annimmt. Beim Definieren eigener Attribute können Sie einen Standardwert deklarieren, indem Sie entweder einen Konstruktor bereitstellen, der keine Argumente akzeptiert, oder indem Sie ein öffentliches statisches Feld Ihres Attributtyps namens "Default" definieren.

Konstruktoren

Felder

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Weitere Informationen

• Attribute
• BrowsableAttribute
• DescriptionAttribute