AttributeCollection.Matches AttributeCollection.Matches AttributeCollection.Matches AttributeCollection.Matches Method

Definition

Bestimmt, ob ein angegebenes Attribut oder Attributarray mit einem Attribut oder Attributarray in der Auflistung übereinstimmt.Determines whether a specified attribute or array of attributes is the same as an attribute or array of attributes in the collection.

Überlädt

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.

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.

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

Parameter

attribute
Attribute Attribute Attribute Attribute

Eine Instanz der Attribute-Klasse, die mit den Attributen in dieser Auflistung verglichen werden soll.An instance of Attribute to compare with the attributes in this collection.

Gibt zurück

true, wenn das Attribut in der Auflistung enthalten ist und denselben Wert hat wie das Attribut in der Auflistung, andernfalls false.true if the attribute is contained within the collection and has the same value as the attribute in the collection; otherwise, false.

Beispiele

Im folgenden Codebeispiel wird überprüft, ob die BrowsableAttribute ist ein Mitglied der Sammlung und, die sie festgelegt wurde true.The following code example verifies that the BrowsableAttribute is a member of the collection and that it has been set to true. Es wird vorausgesetzt, dass button1 und textBox1 in einem Formular erstellt wurden.It assumes that button1 and textBox1 have been created on a form.

private:
   void MatchesAttribute()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ attributes;
      attributes = TypeDescriptor::GetAttributes( button1 );
      
      // Checks to see if the browsable attribute is true.
      if ( attributes->Matches( BrowsableAttribute::Yes ) )
      {
         textBox1->Text = "button1 is browsable.";
      }
      else
      {
         textBox1->Text = "button1 is not browsable.";
      }
   }
private void MatchesAttribute() {
    // Creates a new collection and assigns it the attributes for button1.
    AttributeCollection attributes;
    attributes = TypeDescriptor.GetAttributes(button1);
 
    // Checks to see if the browsable attribute is true.
    if (attributes.Matches(BrowsableAttribute.Yes))
       textBox1.Text = "button1 is browsable.";
    else
       textBox1.Text = "button1 is not browsable.";
 }

Private Sub MatchesAttribute
	' Creates a new collection and assigns it the attributes for button
	Dim attributes As AttributeCollection
	attributes = TypeDescriptor.GetAttributes(button1)

	' Checks to see if the browsable attribute is true.
	If attributes.Matches(BrowsableAttribute.Yes) Then
		textBox1.Text = "button1 is browsable."
	Else
		textBox1.Text = "button1 is not browsable."
	End If
   End Sub

Hinweise

Ein Attribut kann die Unterstützung für den Abgleich von bieten.An attribute can provide support for matching.

Der Unterschied zwischen der Matches und Contains Methoden ist, die Matches Aufrufe der Match Methode auf einem Attribut und Contains Aufrufe der Equals Methode.The difference between the Matches and Contains methods is that Matches calls the Match method on an attribute, and Contains calls the Equals method.

Diese Methoden werden genauso vorgehen, für die meisten Attribute.For most attributes, these methods do the same thing. Für Attribute, die mehrere Flags, die jedoch möglicherweise Match wird in der Regel implementiert, sodass sie zurückgibt true Wenn keines der Flags erfüllt sind.For attributes that may have multiple flags, however, Match is typically implemented so that it returns true if any of the flags are satisfied. Betrachten Sie beispielsweise eine Datenbindungsattribut mit booleschen Flags "SupportsSql", "SupportsOleDb" und "SupportsXml" aus.For example, consider a data binding attribute with the Boolean flags "SupportsSql", "SupportsOleDb", and "SupportsXml". Dieses Attribut kann auf eine Eigenschaft vorhanden sein, die alle drei Datenbindung Ansätze unterstützt.This attribute may be present on a property that supports all three data binding approaches. Sie werden häufig der Fall, der Programmierer muss nur wissen, ob eine bestimmte Methode 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 können Programmierer Match mit einer Instanz des Attributs, enthält nur die Flags des Programmierers muss.Therefore, a programmer could use Match with an instance of the attribute containing only the flags the programmer needs.

Siehe auch

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.

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

Parameter

attributes
Attribute[]

Ein Array von MemberAttributes, das mit den Attributen in dieser Auflistung verglichen werden soll.An array of MemberAttributes to compare with the attributes in this collection.

Gibt zurück

true, wenn sämtliche Attribute im Array in der Auflistung enthalten sind und dieselben Werte haben wie die Attribute in der Auflistung, andernfalls false.true if all the attributes in the array are contained in the collection and have the same values as the attributes in the collection; otherwise, false.

Beispiele

Im folgenden Codebeispiel werden die Attribute in einer Schaltfläche und ein Textfeld, um festzustellen, ob sie übereinstimmen verglichen.The following code example compares the attributes in a button and a text box to see whether they match. Es wird vorausgesetzt, dass button1 und textBox1 in einem Formular erstellt wurden.It assumes that button1 and textBox1 have been created on a form.

private:
   void MatchesAttributes()
   {
      // 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 match the attributes for textBox1.
      array<Attribute^>^ myAttrArray = gcnew array<Attribute^>(100);
      TypeDescriptor::GetAttributes( textBox1 )->CopyTo( myAttrArray, 0 );
      if ( myCollection->Matches( myAttrArray ) )
      {
         textBox1->Text = "The attributes in the button and text box match.";
      }
      else
      {
         textBox1->Text = "The attributes in the button and text box do not match.";
      }
   }
private void MatchesAttributes() {
   // 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 match the attributes for textBox1.
   Attribute[] myAttrArray = new Attribute[100];
   TypeDescriptor.GetAttributes(textBox1).CopyTo(myAttrArray, 0);
   if (myCollection.Matches(myAttrArray))
      textBox1.Text = "The attributes in the button and text box match.";
   else
      textBox1.Text = "The attributes in the button and text box do not match.";
}
Private Sub MatchesAttributes()
    ' 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 match the attributes.
    ' for textBox1.
    Dim myAttrArray(100) As Attribute
    TypeDescriptor.GetAttributes(textBox1).CopyTo(myAttrArray, 0)
    If myCollection.Matches(myAttrArray) Then
        textBox1.Text = "The attributes in the button and text box match."
    Else
        textBox1.Text = "The attributes in the button and text box do not match."
    End If
End Sub

Hinweise

Ein Attribut kann die Unterstützung für den Abgleich von bieten.An attribute can provide support for matching.

Siehe auch

Gilt für: