AttributeCollection AttributeCollection AttributeCollection AttributeCollection Class

Definição

Representa uma coleção de atributos.Represents a collection of attributes.

public ref class AttributeCollection : System::Collections::ICollection
[System.Runtime.InteropServices.ComVisible(true)]
public class AttributeCollection : System.Collections.ICollection
type AttributeCollection = class
    interface ICollection
    interface IEnumerable
Public Class AttributeCollection
Implements ICollection
Herança
AttributeCollectionAttributeCollectionAttributeCollectionAttributeCollection
Atributos
Implementações

Exemplos

O primeiro exemplo de código verifica se o BrowsableAttribute foi definido nesta coleção.The first code example checks to see whether the BrowsableAttribute has been set in this collection. O segundo exemplo de código obtém o valor real do DescriptionAttribute para um botão.The second code example gets the actual value of the DescriptionAttribute for a button. Ambos os exemplos exigem button1 que textBox1 e tenham sido criados em um formulário.Both examples require that button1 and textBox1 have been created on a form. Ao usar atributos, verifique se um atributo foi definido ou acesse seu valor.When using attributes, verify that an attribute has been set, or access its value.

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 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 button1.
    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
private:
   void GetAttributeValue()
   {
      // Creates a new collection and assigns it the attributes for button1.
      AttributeCollection^ attributes;
      attributes = TypeDescriptor::GetAttributes( button1 );
      
      // Gets the designer attribute from the collection.
      DesignerAttribute^ myDesigner;
      myDesigner = (DesignerAttribute^)(attributes[DesignerAttribute::typeid]);
      
      // Prints the value of the attribute in a text box.
      textBox1->Text = myDesigner->DesignerTypeName;
   }
private void GetAttributeValue() {
    // Creates a new collection and assigns it the attributes for button1.
    AttributeCollection attributes;
    attributes = TypeDescriptor.GetAttributes(button1);
 
    // Gets the designer attribute from the collection.
    DesignerAttribute myDesigner; 
    myDesigner = (DesignerAttribute)attributes[typeof(DesignerAttribute)];
 
    // Prints the value of the attribute in a text box.
    textBox1.Text = myDesigner.DesignerTypeName;
 }
Private Sub GetAttributeValue()
    ' Creates a new collection and assigns it the attributes for button1.
    Dim attributes As AttributeCollection
    attributes = TypeDescriptor.GetAttributes(button1)
    
    ' Gets the designer attribute from the collection.
    Dim myDesigner As DesignerAttribute
    myDesigner = CType(attributes(GetType(DesignerAttribute)), DesignerAttribute)
    
    ' Prints the value of the attribute in a text box.
    textBox1.Text = myDesigner.DesignerTypeName
End Sub

Comentários

A AttributeCollection classe é somente leitura; ela não implementa métodos para adicionar ou remover atributos.The AttributeCollection class is read-only; it does not implement methods to add or remove attributes. Você deve herdar dessa classe para implementar esses métodos.You must inherit from this class to implement these methods.

Use a Count propriedade para localizar o número de atributos que existem na coleção.Use the Count property to find the number of attributes that exist in the collection.

Você também pode usar os métodos dessa classe para consultar a coleção sobre seu conteúdo.You can also use the methods of this class to query the collection about its contents. Chame o Contains método para verificar se existe um atributo ou matriz de atributo especificado na coleção.Call the Contains method to verify that a specified attribute or attribute array exists in the collection. Chame o Matches método para verificar se um atributo ou matriz de atributos especificado existe na coleção e se os valores dos atributos especificados são os mesmos que os valores na coleção.Call the Matches method to verify that a specified attribute or array of attributes exists in the collection, and that the values of the specified attributes are the same as the values in the collection.

Embora a maioria dos atributos tenha valores padrão, os valores padrão não são necessários.While most attributes have default values, default values are not required. Se um atributo não tiver nenhum valor padrão null , será retornado da propriedade indexada que usa um tipo.If an attribute has no default value, null is returned from the indexed property that takes a type. Ao definir seus próprios atributos, você pode declarar um valor padrão fornecendo um construtor que não usa argumentos ou definindo um campo estático público do tipo de atributo chamado "default".When defining your own attributes, you can declare a default value by either providing a constructor that takes no arguments, or defining a public static field of your attribute type named "Default".

Construtores

AttributeCollection() AttributeCollection() AttributeCollection() AttributeCollection()

Inicializa uma nova instância da classe AttributeCollection.Initializes a new instance of the AttributeCollection class.

AttributeCollection(Attribute[]) AttributeCollection(Attribute[]) AttributeCollection(Attribute[]) AttributeCollection(Attribute[])

Inicializa uma nova instância da classe AttributeCollection.Initializes a new instance of the AttributeCollection class.

Campos

Empty Empty Empty Empty

Especifica uma coleção vazia que você pode usar, em vez de criar uma nova.Specifies an empty collection that you can use, rather than creating a new one. Este campo é somente leitura.This field is read-only.

Propriedades

Attributes Attributes Attributes Attributes

Obtém a coleção de atributos.Gets the attribute collection.

Count Count Count Count

Obtém o número de atributos.Gets the number of attributes.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtém o atributo com o número de índice especificado.Gets the attribute with the specified index number.

Item[Type] Item[Type] Item[Type] Item[Type]

Obtém o atributo com o tipo especificado.Gets the attribute with the specified type.

Métodos

Contains(Attribute) Contains(Attribute) Contains(Attribute) Contains(Attribute)

Determina se esta coleção de atributos tem o atributo especificado.Determines whether this collection of attributes has the specified attribute.

Contains(Attribute[]) Contains(Attribute[]) Contains(Attribute[]) Contains(Attribute[])

Determina se essa coleção de atributos contém todos os atributos especificados na matriz de atributos.Determines whether this attribute collection contains all the specified attributes in the attribute array.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copia a coleção para uma matriz, começando no índice especificado.Copies the collection to an array, starting at the specified index.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FromExisting(AttributeCollection, Attribute[]) FromExisting(AttributeCollection, Attribute[]) FromExisting(AttributeCollection, Attribute[]) FromExisting(AttributeCollection, Attribute[])

Cria um novo AttributeCollection de um AttributeCollection existente.Creates a new AttributeCollection from an existing AttributeCollection.

GetDefaultAttribute(Type) GetDefaultAttribute(Type) GetDefaultAttribute(Type) GetDefaultAttribute(Type)

Retorna o Attribute padrão de um determinado Type.Returns the default Attribute of a given Type.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Obtém um enumerador para esta coleção.Gets an enumerator for this collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
Matches(Attribute) Matches(Attribute) Matches(Attribute) Matches(Attribute)

Determina se um atributo especificado é o mesmo que um atributo na coleção.Determines whether a specified attribute is the same as an attribute in the collection.

Matches(Attribute[]) Matches(Attribute[]) Matches(Attribute[]) Matches(Attribute[])

Determina se os atributos na matriz especificada são os mesmos que os atributos na coleção.Determines whether the attributes in the specified array are the same as the attributes in the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Implantações explícitas de interface

ICollection.Count ICollection.Count ICollection.Count ICollection.Count

Obtém o número de elementos contidos na coleção.Gets the number of elements contained in the collection.

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Obtém um valor que indica se o acesso à coleção é sincronizado (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread-safe).

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Retorna um IEnumerator para o IDictionary.Returns an IEnumerator for the IDictionary.

Métodos de Extensão

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também