AttributeCollection.Matches Método

Definición

Determina si un atributo o una matriz de atributos especificados coincide con un atributo o una matriz de atributos de la colección.Determines whether a specified attribute or array of attributes is the same as an attribute or array of attributes in the collection.

Sobrecargas

Matches(Attribute)

Determina si un atributo especificado es igual a un atributo de la colección.Determines whether a specified attribute is the same as an attribute in the collection.

Matches(Attribute[])

Determina si los atributos en la matriz especificada son iguales a los de la colección.Determines whether the attributes in the specified array are the same as the attributes in the collection.

Matches(Attribute)

Determina si un atributo especificado es igual a un atributo de la colección.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

Parámetros

attribute
Attribute

Instancia de Attribute que se va a comparar con los atributos de esta colección.An instance of Attribute to compare with the attributes in this collection.

Devoluciones

true si el atributo forma parte de la colección y tiene el mismo valor que el atributo de la colección; en caso contrario, false.true if the attribute is contained within the collection and has the same value as the attribute in the collection; otherwise, false.

Ejemplos

En el ejemplo de código siguiente BrowsableAttribute se comprueba que es un miembro de la colección y que se ha establecido en. trueThe following code example verifies that the BrowsableAttribute is a member of the collection and that it has been set to true. Se supone que button1 y textBox1 se han creado en un formulario.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

Comentarios

Un atributo puede proporcionar compatibilidad con la búsqueda de coincidencias.An attribute can provide support for matching.

La diferencia entre los Matches métodos Contains y es que Matches llama al Match método en un atributo y Contains llama al Equals método.The difference between the Matches and Contains methods is that Matches calls the Match method on an attribute, and Contains calls the Equals method.

Para la mayoría de los atributos, estos métodos hacen lo mismo.For most attributes, these methods do the same thing. En el caso de los atributos que pueden tener varias Match marcas, sin embargo, se implementa true normalmente para que devuelva si se cumple alguna de las marcas.For attributes that may have multiple flags, however, Match is typically implemented so that it returns true if any of the flags are satisfied. Por ejemplo, considere un atributo de enlace de datos con las marcas booleanas "SupportsSql", "SupportsOleDb" y "SupportsXml".For example, consider a data binding attribute with the Boolean flags "SupportsSql", "SupportsOleDb", and "SupportsXml". Este atributo puede estar presente en una propiedad que admita los tres métodos de enlace de datos.This attribute may be present on a property that supports all three data binding approaches. Suele ser el caso de que un programador solo necesite saber si un enfoque determinado está disponible, no los tres.It will often be the case that a programmer needs to know only if a particular approach is available, not all three. Por lo tanto, un programador Match puede usar con una instancia del atributo que contenga solo las marcas que necesita el programador.Therefore, a programmer could use Match with an instance of the attribute containing only the flags the programmer needs.

Consulte también:

Matches(Attribute[])

Determina si los atributos en la matriz especificada son iguales a los de la colección.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

Parámetros

attributes
Attribute[]

Matriz de MemberAttributes que se va a comparar con los atributos de esta colección.An array of MemberAttributes to compare with the attributes in this collection.

Devoluciones

true si todos los atributos de la matriz forman parte de la colección y tienen los mismos valores que los atributos de la colección; en caso contrario, 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.

Ejemplos

En el ejemplo de código siguiente se comparan los atributos de un botón y un cuadro de texto para ver si coinciden.The following code example compares the attributes in a button and a text box to see whether they match. Se supone que button1 y textBox1 se han creado en un formulario.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

Comentarios

Un atributo puede proporcionar compatibilidad con la búsqueda de coincidencias.An attribute can provide support for matching.

Consulte también:

Se aplica a