AttributeCollection AttributeCollection AttributeCollection AttributeCollection Class

Definizione

Rappresenta un insieme di attributi.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
Ereditarietà
AttributeCollectionAttributeCollectionAttributeCollectionAttributeCollection
Attributi
Implementazioni

Esempi

Il primo esempio di codice consente di controllare se il BrowsableAttribute è stato impostato in questa raccolta.The first code example checks to see whether the BrowsableAttribute has been set in this collection. Il secondo esempio di codice ottiene il valore effettivo del DescriptionAttribute per un pulsante.The second code example gets the actual value of the DescriptionAttribute for a button. Entrambi gli esempi richiedono che button1 e textBox1 sono stati creati in un form.Both examples require that button1 and textBox1 have been created on a form. Quando si usano gli attributi, verificare che è stato impostato un attributo o il relativo valore di accesso.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 'ContainsAttribute
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 'GetAttributeValue

Commenti

Il AttributeCollection classe è di sola lettura; non implementa i metodi per aggiungere o rimuovere gli attributi.The AttributeCollection class is read-only; it does not implement methods to add or remove attributes. È necessario ereditare da questa classe per implementare questi metodi.You must inherit from this class to implement these methods.

Usare il Count proprietà per trovare il numero di attributi presenti nella raccolta.Use the Count property to find the number of attributes that exist in the collection.

È anche possibile usare i metodi di questa classe per eseguire una query il contenuto dell'insieme.You can also use the methods of this class to query the collection about its contents. Chiamare il Contains metodo per verificare che esista un attributo specificato o una matrice di attributi nella raccolta.Call the Contains method to verify that a specified attribute or attribute array exists in the collection. Chiamare il Matches metodo per verificare che esista nella raccolta di un attributo specificato o una matrice di attributi e che i valori degli attributi specificati siano uguali ai valori nella raccolta.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.

Mentre la maggior parte degli attributi hanno valori predefiniti, i valori predefiniti non sono più necessari.While most attributes have default values, default values are not required. Se un attributo non dispone di alcun valore predefinito, null viene restituito dalla proprietà indicizzata che accetta un tipo.If an attribute has no default value, null is returned from the indexed property that takes a type. Quando si definiscono i propri attributi, è possibile dichiarare un valore predefinito che fornisce un costruttore che non accetta argomenti, o definizione di un campo statico pubblico del tipo di attributo denominato "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".

Costruttori

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

Inizializza una nuova istanza della classe AttributeCollection.Initializes a new instance of the AttributeCollection class.

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

Inizializza una nuova istanza della classe AttributeCollection.Initializes a new instance of the AttributeCollection class.

Campi

Empty Empty Empty Empty

Specifica un insieme vuoto da utilizzare invece di crearne uno nuovo.Specifies an empty collection that you can use, rather than creating a new one. Questo campo è di sola lettura.This field is read-only.

Proprietà

Attributes Attributes Attributes Attributes

Ottiene l'insieme di attributi.Gets the attribute collection.

Count Count Count Count

Ottiene il numero di attributi.Gets the number of attributes.

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

Ottiene l'attributo con il numero di indice specificato.Gets the attribute with the specified index number.

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

Ottiene l'attributo con il tipo specificato.Gets the attribute with the specified type.

Metodi

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

Consente di determinare se questo insieme di attributi dispone dell'attributo specificato.Determines whether this collection of attributes has the specified attribute.

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

Consente di determinare se questo insieme di attributi contiene tutti gli attributi specificati nella matrice di attributi.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)

Consente di copiare l'insieme in una matrice partendo dall'indice specificato.Copies the collection to an array, starting at the specified index.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.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[])

Crea un nuovo insieme AttributeCollection da un insieme AttributeCollection esistente.Creates a new AttributeCollection from an existing AttributeCollection.

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

Restituisce l'oggetto Attribute predefinito di un dato oggetto Type.Returns the default Attribute of a given Type.

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

Ottiene un enumeratore per questo insieme.Gets an enumerator for this collection.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Consente di determinare se un attributo specificato è uguale a un attributo nell'insieme.Determines whether a specified attribute is the same as an attribute in the collection.

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

Consente di determinare se gli attributi nella matrice specificata sono uguali agli attributi dell'insieme.Determines whether the attributes in the specified array are the same as the attributes in the collection.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Ottiene il numero di elementi contenuti nella raccolta.Gets the number of elements contained in the collection.

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

Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread-safe).

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

Ottiene un oggetto che può essere usato per sincronizzare l'accesso alla raccolta.Gets an object that can be used to synchronize access to the collection.

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

Viene restituito un IEnumerator per l'oggetto IDictionary.Returns an IEnumerator for the IDictionary.

Extension Methods

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

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

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

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

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

Consente la parallelizzazione di una query.Enables parallelization of a query.

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

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche