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 die BrowsableAttribute In dieser Auflistung festgelegt wurde. Im zweiten Codebeispiel wird der tatsächliche Wert der DescriptionAttribute Schaltfläche abgerufen. Für beide Beispiele ist es erforderlich, dass button1 sie textBox1 auf einem Formular erstellt wurden. Überprüfen Sie bei der Verwendung von Attributen, ob ein Attribut festgelegt wurde, oder greifen Sie auf seinen 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.";
      }
   }

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;

    textBox1.Text = attributes.Contains(myAttribute) ? "button1 has a browsable attribute." : "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;
   }

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 Klasse ist schreibgeschützt. Sie AttributeCollection 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 finden, die in der Auflistung vorhanden sind.

Sie können auch die Methoden dieser Klasse verwenden, um die Auflistung über den Inhalt 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 identisch sind.

Die meisten Attribute weisen zwar Standardwerte auf, Standardwerte sind jedoch nicht erforderlich. Wenn ein Attribut keinen Standardwert aufweist, wird von der indizierten Eigenschaft zurückgegeben, null die einen Typ verwendet. Beim Definieren eigener Attribute können Sie einen Standardwert deklarieren, indem Sie entweder einen Konstruktor bereitstellen, der keine Argumente akzeptiert, oder ein öffentliches statisches Feld des Attributtyps "Default" definieren.

Weitere Informationen

• Attribute
• BrowsableAttribute
• DescriptionAttribute