AttributeCollection Classe

Définition

Représente une collection d’attributs.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
Héritage
AttributeCollection
Attributs
Implémente

Exemples

Le premier exemple de code vérifie si la BrowsableAttribute a été définie dans cette collection.The first code example checks to see whether the BrowsableAttribute has been set in this collection. Le deuxième exemple de code obtient la valeur réelle de la DescriptionAttribute pour un bouton.The second code example gets the actual value of the DescriptionAttribute for a button. Les deux exemples requièrent que button1 et textBox1 aient été créés sur un formulaire.Both examples require that button1 and textBox1 have been created on a form. Lorsque vous utilisez des attributs, vérifiez qu’un attribut a été défini ou accédez à sa valeur.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

Remarques

La classe AttributeCollection est en lecture seule ; elle n’implémente pas de méthodes pour ajouter ou supprimer des attributs.The AttributeCollection class is read-only; it does not implement methods to add or remove attributes. Vous devez hériter de cette classe pour implémenter ces méthodes.You must inherit from this class to implement these methods.

Utilisez la propriété Count pour rechercher le nombre d’attributs qui existent dans la collection.Use the Count property to find the number of attributes that exist in the collection.

Vous pouvez également utiliser les méthodes de cette classe pour interroger la collection sur son contenu.You can also use the methods of this class to query the collection about its contents. Appelez la méthode Contains pour vérifier qu’un attribut ou un tableau d’attributs spécifié existe dans la collection.Call the Contains method to verify that a specified attribute or attribute array exists in the collection. Appelez la méthode Matches pour vérifier qu’un attribut ou un tableau d’attributs spécifié existe dans la collection et que les valeurs des attributs spécifiés sont les mêmes que celles de la collection.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.

Alors que la plupart des attributs ont des valeurs par défaut, les valeurs par défaut ne sont pas requises.While most attributes have default values, default values are not required. Si un attribut n’a pas de valeur par défaut, null est retourné à partir de la propriété indexée qui accepte un type.If an attribute has no default value, null is returned from the indexed property that takes a type. Quand vous définissez vos propres attributs, vous pouvez déclarer une valeur par défaut en fournissant un constructeur qui n’accepte aucun argument ou en définissant un champ statique public de votre type d’attribut nommé « 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".

Constructeurs

AttributeCollection()

Initialise une nouvelle instance de la classe AttributeCollection.Initializes a new instance of the AttributeCollection class.

AttributeCollection(Attribute[])

Initialise une nouvelle instance de la classe AttributeCollection.Initializes a new instance of the AttributeCollection class.

Champs

Empty

Spécifie une collection vide que vous pouvez utiliser, plutôt que d'en créer une nouvelle.Specifies an empty collection that you can use, rather than creating a new one. Ce champ est en lecture seule.This field is read-only.

Propriétés

Attributes

Obtient la collection d'attributs.Gets the attribute collection.

Count

Obtient le nombre d'attributs.Gets the number of attributes.

Item[Int32]

Obtient l'attribut avec le numéro d'index spécifié.Gets the attribute with the specified index number.

Item[Type]

Obtient l'attribut du type spécifié.Gets the attribute with the specified type.

Méthodes

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.

CopyTo(Array, Int32)

Copie la collection dans un tableau, en commençant à l'index spécifié.Copies the collection to an array, starting at the specified index.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
FromExisting(AttributeCollection, Attribute[])

Crée un nouveau AttributeCollection à partir d'un AttributeCollection existant.Creates a new AttributeCollection from an existing AttributeCollection.

GetDefaultAttribute(Type)

Retourne le Attribute par défaut d'un Type donné.Returns the default Attribute of a given Type.

GetEnumerator()

Obtient un énumérateur pour cette collection.Gets an enumerator for this collection.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
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.

MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

ICollection.Count

Obtient le nombre d’éléments contenus dans la collection.Gets the number of elements contained in the collection.

ICollection.IsSynchronized

Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread-safe).

ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

Renvoie un IEnumerator pour le IDictionary.Returns an IEnumerator for the IDictionary.

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi