AttributeCollection.Matches Méthode

Définition

Détermine si un attribut ou un tableau d'attributs spécifié est identique à un attribut ou à un tableau d'attributs de la collection.Determines whether a specified attribute or array of attributes is the same as an attribute or array of attributes in the collection.

Surcharges

Matches(Attribute)

Détermine si un attribut spécifié est identique à un attribut de la collection.Determines whether a specified attribute is the same as an attribute in the collection.

Matches(Attribute[])

Détermine si les attributs du tableau spécifié sont identiques aux attributs de la collection.Determines whether the attributes in the specified array are the same as the attributes in the collection.

Matches(Attribute)

Détermine si un attribut spécifié est identique à un attribut de la collection.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

Paramètres

attribute
Attribute

Instance de Attribute à comparer avec les attributs de cette collection.An instance of Attribute to compare with the attributes in this collection.

Retours

true si l'attribut est contenu dans la collection et possède la même valeur que l'attribut dans la collection ; sinon, false.true if the attribute is contained within the collection and has the same value as the attribute in the collection; otherwise, false.

Exemples

L’exemple de code suivant vérifie que le BrowsableAttribute est membre de la collection et qu’il a été défini sur true.The following code example verifies that the BrowsableAttribute is a member of the collection and that it has been set to true. Il suppose que button1 et textBox1 ont été créés sur un formulaire.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

Remarques

Un attribut peut fournir une prise en charge pour la correspondance.An attribute can provide support for matching.

La différence entre les méthodes Matches et Contains est que Matches appelle la méthode Match sur un attribut et Contains appelle la méthode Equals.The difference between the Matches and Contains methods is that Matches calls the Match method on an attribute, and Contains calls the Equals method.

Pour la plupart des attributs, ces méthodes font la même chose.For most attributes, these methods do the same thing. Toutefois, pour les attributs qui peuvent avoir plusieurs indicateurs, Match est généralement implémenté afin qu’il retourne true si l’un des indicateurs est respecté.For attributes that may have multiple flags, however, Match is typically implemented so that it returns true if any of the flags are satisfied. Par exemple, considérez un attribut de liaison de données avec les indicateurs booléens « SupportsSql », « SupportsOleDb » et « SupportsXml ».For example, consider a data binding attribute with the Boolean flags "SupportsSql", "SupportsOleDb", and "SupportsXml". Cet attribut peut être présent sur une propriété qui prend en charge les trois approches de liaison de données.This attribute may be present on a property that supports all three data binding approaches. C’est souvent le cas lorsqu’un programmeur doit savoir uniquement si une approche particulière est disponible, pas les trois.It will often be the case that a programmer needs to know only if a particular approach is available, not all three. Par conséquent, un programmeur peut utiliser Match avec une instance de l’attribut qui contient uniquement les indicateurs dont le programmeur a besoin.Therefore, a programmer could use Match with an instance of the attribute containing only the flags the programmer needs.

Voir aussi

Matches(Attribute[])

Détermine si les attributs du tableau spécifié sont identiques aux attributs de la collection.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

Paramètres

attributes
Attribute[]

Tableau de MemberAttributes à comparer avec les attributs de cette collection.An array of MemberAttributes to compare with the attributes in this collection.

Retours

true si tous les attributs du tableau sont contenus dans la collection et possèdent les mêmes valeurs que les attributs de la collection ; sinon, 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.

Exemples

L’exemple de code suivant compare les attributs d’un bouton et d’une zone de texte pour voir s’ils correspondent.The following code example compares the attributes in a button and a text box to see whether they match. Il suppose que button1 et textBox1 ont été créés sur un formulaire.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

Remarques

Un attribut peut fournir une prise en charge pour la correspondance.An attribute can provide support for matching.

Voir aussi

S’applique à