PropertyDescriptorCollection Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

PropertyDescriptorCollection.cs

Représente une collection d'objets PropertyDescriptor.

public ref class PropertyDescriptorCollection : System::Collections::IDictionary, System::Collections::IList

public class PropertyDescriptorCollection : System.Collections.IDictionary, System.Collections.IList

type PropertyDescriptorCollection = class
    interface ICollection
    interface IEnumerable
    interface IDictionary
    interface IList

Public Class PropertyDescriptorCollection
Implements IDictionary, IList

Héritage

Object

PropertyDescriptorCollection

Implémente

ICollection IDictionary IEnumerable IList

Exemples

L’exemple de code suivant en crée un à PropertyDescriptorCollection l’aide des propriétés sur button1. Il nécessite que l’instanciation button1 ait été effectuée sur un formulaire.

PropertyDescriptorCollection^ properties = TypeDescriptor::GetProperties( button1 );

PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);

Dim properties As PropertyDescriptorCollection = TypeDescriptor.GetProperties(button1)

L’exemple suivant affiche toutes les propriétés d’un bouton dans une zone de texte. Il nécessite que button1 et textBox1 ont été instanciés sur un formulaire.

private:
   void MyPropertyCollection()
   {
      // Creates a new collection and assign it the properties for button1.
      PropertyDescriptorCollection^ properties = TypeDescriptor::GetProperties( button1 );
      
      // Displays each property in the collection in a text box.
      for each ( PropertyDescriptor^ myProperty in properties )
      {
         textBox1->Text = String::Concat( textBox1->Text, myProperty->Name, "\n" );
      }
   }

private void MyPropertyCollection() {
    // Creates a new collection and assign it the properties for button1.
    PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);
 
    // Displays each property in the collection in a text box.
    foreach (PropertyDescriptor myProperty in properties)
       textBox1.Text += myProperty.Name + '\n';
 }

Private Sub MyPropertyCollection()
    ' Creates a new collection and assign it the properties for button1.
    Dim properties As PropertyDescriptorCollection = TypeDescriptor.GetProperties(button1)
    
    ' Displays each property in the collection in a text box.
    Dim myProperty As PropertyDescriptor
    For Each myProperty In  properties
        textBox1.Text &= myProperty.Name & ControlChars.Cr
    Next myProperty
End Sub

Remarques

PropertyDescriptorCollection est en lecture seule ; il n’implémente pas de méthodes qui ajoutent ou suppriment des propriétés. Vous devez hériter de cette classe pour implémenter ces méthodes.

À l’aide des propriétés disponibles dans la PropertyDescriptorCollection classe, vous pouvez interroger la collection sur son contenu. Utilisez la propriété Count pour déterminer le nombre d’éléments dans la collection. Utilisez la Item[] propriété pour obtenir une propriété spécifique par numéro d’index ou par nom.

En plus des propriétés, vous pouvez utiliser la Find méthode pour obtenir une description de la propriété avec le nom spécifié à partir de la collection.

Constructeurs

PropertyDescriptorCollection(PropertyDescriptor[])	Initialise une nouvelle instance de la classe PropertyDescriptorCollection.
PropertyDescriptorCollection(PropertyDescriptor[], Boolean)	Initialise une nouvelle instance de la classe PropertyDescriptorCollection, qui est éventuellement en lecture seule.

Champs

Empty

Spécifie une collection vide que vous pouvez utiliser, plutôt que d'en créer une sans élément. Ce champ static est en lecture seule.

Propriétés

Count	Obtient le nombre de descripteurs de propriété dans la collection.
Item[Int32]	Obtient ou définit le PropertyDescriptor situé au numéro d'index spécifié.
Item[String]	Obtient ou définit PropertyDescriptor portant le nom spécifié.

Méthodes

Add(PropertyDescriptor)	Ajoute l'objet PropertyDescriptor spécifié à la collection.
Clear()	Supprime tous les objets PropertyDescriptor de la collection.
Contains(PropertyDescriptor)	Retourne une valeur indiquant si la collection contient le PropertyDescriptor donné.
CopyTo(Array, Int32)	Copie la totalité de la collection dans un tableau, en commençant au numéro d'index spécifié.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Find(String, Boolean)	Retourne le PropertyDescriptor portant le nom spécifié, en utilisant une valeur booléenne pour indiquer si la casse doit être ignorée.
GetEnumerator()	Retourne un énumérateur pour cette classe.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(PropertyDescriptor)	Retourne l'index du PropertyDescriptor donné.
Insert(Int32, PropertyDescriptor)	Ajoute PropertyDescriptor à la collection, au numéro d'index spécifié.
InternalSort(IComparer)	Trie les membres de cette collection avec le IComparer spécifié.
InternalSort(String[])	Trie les membres de cette collection. L'ordre spécifié est appliqué en premier, suivi du tri par défaut pour cette collection (généralement l'ordre alphabétique).
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(PropertyDescriptor)	Supprime l’objet PropertyDescriptor spécifié de la collection.
RemoveAt(Int32)	Supprime le PropertyDescriptor à l'index spécifié dans la collection.
Sort()	Trie les membres de cette collection en appliquant le tri par défaut pour cette collection, c'est-à-dire généralement l'ordre alphabétique.
Sort(IComparer)	Trie les membres de cette collection avec le IComparer spécifié.
Sort(String[])	Trie les membres de cette collection. L'ordre spécifié est appliqué en premier, suivi du tri par défaut pour cette collection (généralement l'ordre alphabétique).
Sort(String[], IComparer)	Trie les membres de cette collection. L'ordre spécifié est appliqué en premier, suivi du tri qui utilise le IComparer spécifié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICollection.Count	Obtient le nombre d’éléments contenus dans la collection.
ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.
IDictionary.Add(Object, Object)	Ajoute un élément avec la clé et la valeur fournies à IDictionary.
IDictionary.Clear()	Supprime tous les éléments de IDictionary.
IDictionary.Contains(Object)	Détermine si IDictionary contient un élément avec la clé spécifiée.
IDictionary.GetEnumerator()	Retourne un énumérateur pour cette classe.
IDictionary.IsFixedSize	Obtient une valeur indiquant si IDictionary est de taille fixe.
IDictionary.IsReadOnly	Obtient une valeur indiquant si IDictionary est en lecture seule.
IDictionary.Item[Object]	Obtient ou définit l'élément à l'aide de la clé spécifiée.
IDictionary.Keys	Obtient un ICollection contenant les clés de IDictionary.
IDictionary.Remove(Object)	Supprime de IDictionary l'élément ayant la clé spécifiée.
IDictionary.Values	Obtient ICollection contenant les valeurs de IDictionary.
IEnumerable.GetEnumerator()	Retourne IEnumerator pour l'objet IDictionary.
IList.Add(Object)	Ajoute un élément à IList.
IList.Clear()	Supprime tous les éléments de la collection.
IList.Contains(Object)	Détermine si la collection contient une valeur spécifique.
IList.IndexOf(Object)	Détermine l'index d'un élément spécifié dans la collection.
IList.Insert(Int32, Object)	Insère un élément dans la collection à un index spécifié.
IList.IsFixedSize	Obtient une valeur indiquant si la collection est de taille fixe.
IList.IsReadOnly	Obtient une valeur indiquant si la collection est en lecture seule.
IList.Item[Int32]	Obtient ou définit un élément de la collection au niveau de l'index spécifié.
IList.Remove(Object)	Supprime la première occurrence d'une valeur spécifiée dans la collection.
IList.RemoveAt(Int32)	Supprime l'élément à l'index spécifié.

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

Voir aussi

• PropertyDescriptor
• TypeDescriptor