AttributeCollection.Contains Méthode

Définition

Détermine si cette collection d'attributs possède l'attribut ou le tableau d'attributs spécifié.Determines whether this collection of attributes has the specified attribute or array of attributes.

Surcharges

Contains(Attribute)

Détermine si cette collection d'attributs possède l'attribut spécifié.Determines whether this collection of attributes has the specified attribute.

Contains(Attribute[])

Détermine si cette collection d'attributs contient tous les attributs spécifiés dans le tableau d'attributs.Determines whether this attribute collection contains all the specified attributes in the attribute array.

Contains(Attribute)

Détermine si cette collection d'attributs possède l'attribut spécifié.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
Public Function Contains (attribute As Attribute) As Boolean

Paramètres

attribute
Attribute

Attribute à rechercher dans la collection.An Attribute to find in the collection.

Retours

true si la collection contient l'attribut ou est l'attribut par défaut du type d'attribut ; sinon, false.true if the collection contains the attribute or is the default attribute for the type of attribute; otherwise, false.

Exemples

L’exemple de code suivant vérifie si la collection a une BrowsableAttribute définie sur true.The following code example checks to see whether the collection has a BrowsableAttribute 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.

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

Remarques

Cette collection a l’attribut spécifié si le type d’attribut spécifié existe dans la collection, et si la valeur de l’attribut spécifié est identique à la valeur de l’instance de l’attribut dans la collection.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.

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

Contains(Attribute[])

Détermine si cette collection d'attributs contient tous les attributs spécifiés dans le tableau d'attributs.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

Paramètres

attributes
Attribute[]

Tableau de type Attribute à rechercher dans la collection.An array of type Attribute to find in the collection.

Retours

true si la collection contient tous les attributs ; sinon false.true if the collection contains all the attributes; otherwise, false.

Exemples

L’exemple de code suivant compare les attributs dans button1 et textBox1 pour voir si les attributs du bouton sont contenus dans les attributs de la zone de texte.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. Il part du principe que les button1 et textBox1 ont été créés sur un formulaire.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

Remarques

Cette collection contient le tableau spécifié d’attributs si tous les types d’attributs spécifiés existent dans la collection et si chaque attribut du tableau spécifié est le même qu’un attribut de la collection.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.

Voir aussi

S’applique à