EventDescriptorCollection Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Représente une collection d'objets EventDescriptor.

public ref class EventDescriptorCollection : System::Collections::IList

public class EventDescriptorCollection : System.Collections.IList

type EventDescriptorCollection = class
    interface ICollection
    interface IEnumerable
    interface IList

Public Class EventDescriptorCollection
Implements IList

Héritage

Object

EventDescriptorCollection

Implémente

ICollection IEnumerable IList

Exemples

L’exemple de code suivant imprime tous les événements d’un bouton dans une zone de texte. Il nécessite que button1 et textBox1 ont été instanciés sur un formulaire.

private:
   void MyEventCollection()
   {
      // Creates a new collection and assigns it the events for button1.
      EventDescriptorCollection^ events = TypeDescriptor::GetEvents( button1 );
      
      // Displays each event in the collection in a text box.
      for each ( EventDescriptor^ myEvent in events )
      {
         textBox1->Text = String::Concat( textBox1->Text, myEvent->Name, "\n" );
      }
   }

private void MyEventCollection() {
    // Creates a new collection and assigns it the events for button1.
    EventDescriptorCollection events = TypeDescriptor.GetEvents(button1);
 
    // Displays each event in the collection in a text box.
    foreach (EventDescriptor myEvent in events)
       textBox1.Text += myEvent.Name + '\n';
 }

Private Sub MyEventCollection()
    ' Creates a new collection and assigns it the events for button1.
    Dim events As EventDescriptorCollection = TypeDescriptor.GetEvents(button1)
    
    ' Displays each event in the collection in a text box.
    Dim myEvent As EventDescriptor
    For Each myEvent In  events
        textBox1.Text &= myEvent.Name & ControlChars.Cr
    Next myEvent
End Sub

Remarques

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

À l’aide des propriétés disponibles dans la EventDescriptorCollection 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.

Vous pouvez également utiliser la Find méthode pour obtenir une description de l’événement avec le nom spécifié à partir de la collection.

Constructeurs

EventDescriptorCollection(EventDescriptor[])	Initialise une nouvelle instance de la classe EventDescriptorCollection avec le tableau d'objets EventDescriptor donné.
EventDescriptorCollection(EventDescriptor[], Boolean)	Initialise une nouvelle instance de la classe EventDescriptorCollection avec le tableau d'objets EventDescriptor donné. La collection est éventuellement en lecture seule.

Champs

Empty

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

Propriétés

Count	Obtient le nombre de descripteurs d'événement dans la collection.
Item[Int32]	Obtient ou définit l'événement assorti du numéro d'index spécifié.
Item[String]	Obtient ou définit l'événement portant le nom spécifié.

Méthodes

Add(EventDescriptor)	Ajoute un EventDescriptor à la fin de la collection.
Clear()	Supprime tous les objets de la collection.
Contains(EventDescriptor)	Retourne une valeur indiquant si la collection contient le EventDescriptor donné.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Find(String, Boolean)	Obtient la description de l'événement correspondant au nom spécifié dans la collection.
GetEnumerator()	Obtient un énumérateur pour ce EventDescriptorCollection.
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(EventDescriptor)	Retourne l'index du EventDescriptor donné.
Insert(Int32, EventDescriptor)	Insère un EventDescriptor dans la collection à un index spécifié.
InternalSort(IComparer)	Trie les membres de ce EventDescriptorCollection avec le IComparer spécifié.
InternalSort(String[])	Trie les membres de ce EventDescriptorCollection. 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(EventDescriptor)	Supprime l’objet EventDescriptor spécifié de la collection.
RemoveAt(Int32)	Supprime le EventDescriptor à l'index spécifié dans la collection.
Sort()	Trie les membres de ce EventDescriptorCollection avec le tri par défaut pour cette collection (généralement l'ordre alphabétique).
Sort(IComparer)	Trie les membres de ce EventDescriptorCollection avec le IComparer spécifié.
Sort(String[])	Trie les membres de ce EventDescriptorCollection avec un ordre de tri spécifié.
Sort(String[], IComparer)	Trie les membres de ce EventDescriptorCollection avec un ordre de tri spécifié et un IComparer.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)	Copie les éléments de la collection dans un Array, en commençant à un index particulier de Array.
ICollection.Count	Obtient le nombre d’éléments contenus dans la collection.
ICollection.IsSynchronized	Obtient une valeur qui indique si l'accès à la collection est synchronisé.
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.
IEnumerable.GetEnumerator()	Retourne un énumérateur qui itère au sein d’une collection.
IList.Add(Object)	Ajoute un élément à la collection.
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écifique de la collection.
IList.Insert(Int32, Object)	Insère un élément dans la collection à l'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 l'élément au niveau de l'index spécifié.
IList.Remove(Object)	Supprime la première occurrence d’un objet spécifique 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

• EventDescriptor
• TypeDescriptor