AttributeCollection.Contains Methode

Definition

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

Überlädt

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[])

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.

Contains(Attribute)

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

public:
 bool Contains(Attribute ^ attribute);
public bool Contains (Attribute attribute);
member this.Contains : Attribute -> bool

Parameter

attribute
Attribute

Eine Attribute-Klasse, die in der Auflistung gesucht werden soll.An Attribute to find in the collection.

Gibt zurück

true, wenn die Auflistung das Attribut enthält oder das Standardattribut für den Attributtyp ist, andernfalls false.true if the collection contains the attribute or is the default attribute for the type of attribute; otherwise, false.

Beispiele

Im folgenden Codebeispiel wird überprüft, ob für die Auflistung eine BrowsableAttribute auf truefestgelegt ist.The following code example checks to see whether the collection has a BrowsableAttribute set to true. Dabei wird davon ausgegangen, dass button1 und textBox1 auf einem Formular erstellt wurden.It assumes that button1 and textBox1 have been created on a form.

protected:
   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 button.
    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

Hinweise

Diese Auflistung weist das angegebene Attribut auf, wenn der angegebene Attributtyp in der Auflistung vorhanden ist, und, wenn der Wert des angegebenen Attributs mit dem Wert der Instanz des-Attributs in der Auflistung übereinstimmt.This collection has the specified attribute if the specified type of attribute exists in the collection, and if the value of the specified attribute is the same as the value of the instance of the attribute in the collection.

Der Unterschied zwischen den Methoden Matches und Contains besteht darin, dass Matches die Match-Methode für ein Attribut aufruft und Contains die Equals-Methode aufruft.The difference between the Matches and Contains methods is that Matches calls the Match method on an attribute, and Contains calls the Equals method.

Bei den meisten Attributen tun diese Methoden dasselbe.For most attributes, these methods do the same thing. Bei Attributen, die möglicherweise mehrere Flags enthalten, wird Match in der Regel implementiert, sodass true zurückgegeben wird, wenn eines der Flags erfüllt ist.For attributes that may have multiple flags, however, Match is typically implemented so that it returns true if any of the flags are satisfied. Nehmen Sie beispielsweise ein Daten Bindungs Attribut mit den booleschen Flags "SupportsSql", "SupportsOleDb" und "SupportsXml" an.For example, consider a data binding attribute with the Boolean flags "SupportsSql", "SupportsOleDb", and "SupportsXml". Dieses Attribut kann für eine Eigenschaft vorhanden sein, die alle drei Daten Bindungs Ansätze unterstützt.This attribute may be present on a property that supports all three data-binding approaches. Häufig ist es der Fall, dass ein Programmierer nur wissen muss, wenn ein bestimmter Ansatz verfügbar ist, nicht alle drei.It will often be the case that a programmer needs to know only if a particular approach is available, not all three. Aus diesem Grund kann ein Programmierer Match mit einer Instanz des-Attributs verwenden, die nur die vom Programmierer benötigten Flags enthält.Therefore, a programmer could use Match with an instance of the attribute containing only the flags the programmer needs.

Siehe auch

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.

public:
 bool Contains(cli::array <Attribute ^> ^ attributes);
public bool Contains (Attribute[] attributes);
member this.Contains : Attribute[] -> bool
Public Function Contains (attributes As Attribute()) As Boolean

Parameter

attributes
Attribute[]

Ein Array vom Typ Attribute, das in der Auflistung gesucht werden soll.An array of type Attribute to find in the collection.

Gibt zurück

true, wenn die Auflistung sämtliche Attribute enthält, andernfalls false.true if the collection contains all the attributes; otherwise, false.

Beispiele

Im folgenden Codebeispiel werden die Attribute in button1 und textBox1 verglichen, um festzustellen, ob die Attribute für die Schaltfläche in den Attributen für das Textfeld enthalten sind.The following code example compares the attributes in button1 and textBox1 to see whether the attributes for the button are contained in the attributes for the text box. Dabei wird davon ausgegangen, dass sowohl button1 als auch textBox1 in einem Formular erstellt wurden.It assumes that both button1 and textBox1 have been created on a form.

private:
   void ContainsAttributes()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ myCollection;
      myCollection = TypeDescriptor::GetAttributes( button1 );
      
      // Checks to see whether the attributes in myCollection are the attributes for textBox1.
      array<Attribute^>^ myAttrArray = gcnew array<Attribute^>(100);
      TypeDescriptor::GetAttributes( textBox1 )->CopyTo( myAttrArray, 0 );
      if ( myCollection->Contains( myAttrArray ) )
      {
         textBox1->Text = "Both the button and text box have the same attributes.";
      }
      else
      {
         textBox1->Text = "The button and the text box do not have the same attributes.";
      }
   }
private void ContainsAttributes() {
   // Creates a new collection and assigns it the attributes for button1.
   AttributeCollection myCollection;
   myCollection = TypeDescriptor.GetAttributes(button1);    

   // Checks to see whether the attributes in myCollection are the attributes for textBox1.
   Attribute[] myAttrArray = new Attribute[100];
   TypeDescriptor.GetAttributes(textBox1).CopyTo(myAttrArray, 0);
   if (myCollection.Contains(myAttrArray))
      textBox1.Text = "Both the button and text box have the same attributes.";
   else
      textBox1.Text = "The button and the text box do not have the same attributes.";
}
Private Sub ContainsAttributes()
    ' Creates a new collection and assigns it the attributes for button1.
    Dim myCollection As AttributeCollection
    myCollection = TypeDescriptor.GetAttributes(button1)
      
    ' Checks to see whether the attributes in myCollection are the attributes for textBox1.
    Dim myAttrArray(100) As Attribute
    TypeDescriptor.GetAttributes(textBox1).CopyTo(myAttrArray, 0)
    If myCollection.Contains(myAttrArray) Then
        textBox1.Text = "Both the button and text box have the same attributes."
    Else
        textBox1.Text = "The button and the text box do not have the same attributes."
    End If
End Sub

Hinweise

Diese Auflistung verfügt über das angegebene Array von Attributen, wenn alle angegebenen Attributtypen in der Auflistung vorhanden sind und jedes Attribut im angegebenen Array mit einem Attribut in der Auflistung identisch ist.This collection has the specified array of attributes if all the specified attribute types exist in the collection and if each attribute in the specified array is the same as an attribute in the collection.

Siehe auch

Gilt für: