Event |
Événement |
---|---|
Visual Basic .NET (VB .NET) |
Syntaxe
[ attrlist ] [ accessmodifier ] _ [ Shared ] [ Shadows ] Event eventname[(parameterlist)] _ [ Implements implementslist ] |
[ attrlist ] [ accessmodifier ] _ [ Shared ] [ Shadows ] Event eventname As delegatename _ [ Implements implementslist ] |
[ attrlist ] [ accessmodifier ] _ [ Shared ] [ Shadows ] Custom Event eventname As delegatename _ [ Implements implementslist ] [ attrlist ] AddHandler(ByVal value As delegatename) [ statements ] End AddHandler [ attrlist ] RemoveHandler(ByVal value As delegatename) [ statements ] End RemoveHandler [ attrlist ] RaiseEvent(delegatesignature) [ statements ] End RaiseEvent End Event |
Paramètres
Nom | Description | |||
---|---|---|---|---|
attrlist | Ce paramètre permet d'indiquer la liste des attributs s'appliquant à cet événement. Plusieurs attributs sont séparés par des virgules. Vous devez mettre la liste d'attributs entre crochets ("<" et ">"). | |||
accessmodifier | Ce paramètre permet d'indiquer quel code peut accéder à l'événement. Il peut s'agir de l'un des éléments suivants : | |||
Élément | Description | |||
Public | Cet élément permet d'indiquer tout code pouvant accéder à l'élément le déclarant peut y accéder. | |||
Protected | Cet élément permet d'indiquer que seul le code de sa classe ou d'une classe dérivée peut y accéder. | |||
Friend | Cet élément permet d'indiquer que seul le code du même assembly peut y accéder. | |||
Private | Cet élément permet d'indiquer que seul le code de l'élément le déclarant peut y accéder. | |||
Protected Friend | Cet élément permet d'indiquer que seul le code de la classe de l'événement, une classe dérivée ou le même assembly peut y accéder. | |||
Private Protected | Cet élément permet d'indiquer que seul le code dans la classe de l'événement ou une classe dérivée dans le même assembly peut y accéder. | |||
Shared | Ce paramètre permet d'indiquer que cet événement n'est pas associé à une instance spécifique d'une classe ou d'une structure. | |||
Shadows | Ce paramètre permet d'indiquer que cet événement redéclare et masque un élément de programmation du même nom, ou un ensemble d'éléments surchargés, dans une classe de base. Vous pouvez masquer n'importe quel type d'élément déclaré avec n'importe quel autre type. Un élément Shadows n'est pas disponible à partir de la classe dérivée Shadows, sauf à partir de là où l'élément ombré est inaccessible. Par exemple, si un élément Private masque un élément de classe de base, le code n'ayant pas l'autorisation d'accéder à l'élément Private accède à la place à l'élément de classe de base. | |||
eventname | Ce paramètre obligatoire permet d'indiquer le nom de l'événement ; suit les conventions de nommage des variables standard. | |||
parameterlist | Ce paramètre permet d'indiquer la liste des variables locales représentant les paramètres de cet événement. Vous devez mettre la liste des paramètres entre parenthèses. | |||
Implements | Ce paramètre permet d'indiquer que cet événement met en ouvre un événement d'une interface. | |||
implementslist | Ce paramètre obligatoire permet d'indiquer si les outils sont fournis. Liste des sous-procédures mises en ouvre. Plusieurs procédures sont séparées par des virgules :
Chaque procédure mise en oeuvre a la syntaxe et les parties suivantes :
|
|||
Partie | Description | |||
interface | Cette partie permet d'indiquer le nom d'une interface que cette procédure contenant la classe ou la structure mise en oeuvre. | |||
definedname | Cette partie permet d'indiquer le nom par lequel la procédure est définie dans l'interface. Cela ne doit pas nécessairement être le même que name, le nom que cette procédure utilise pour mettre en oeuvre la procédure définie. | |||
Custom | Ce paramètre obligatoire permet d'indiquer les événements déclarés comme Custom doivent définir des accesseurs AddHandler, RemoveHandler et RaiseEvent personnalisés. | |||
delegatename | Ce paramètre permet d'indiquer le nom d'un délégué spécifiant la signature du gestionnaire d'événements. | |||
AddHandler | Ce paramètre permet de déclarer un accesseur AddHandler, spécifiant les instructions à exécuter lorsqu'un gestionnaire d'événements est ajouté, soit explicitement à l'aide de l'instruction AddHandler, soit implicitement à l'aide de la clause Handles. | |||
End AddHandler | Ce paramètre obligatoire permet d'indiquer la terminaison d'un bloc AddHandler. | |||
value | Ce paramètre obligatoire permet d'indiquer le nom du paramètre. | |||
RemoveHandler | Ce paramètre obligatoire permet de déclarer un accesseur RemoveHandler, spécifiant les instructions à exécuter lorsqu'un gestionnaire d'événements est supprimé à l'aide de l'instruction RemoveHandler. | |||
End RemoveHandler | Ce paramètre obligatoire permet d'indiquer la terminaison du bloc RemoveHandler. | |||
RaiseEvent | Ce paramètre obligatoire permet de déclarer un accesseur RaiseEvent, spécifiant les instructions à exécuter lorsque l'événement est déclenché à l'aide de l'instruction RaiseEvent. En général, cela appelle une liste de délégués gérée par les accesseurs AddHandler et RemoveHandler. | |||
End RaiseEvent | Ce paramètre obligatoire permet d'indiquer la terminaison de bloc RaiseEvent. | |||
delegatesignature | Ce paramètre obligatoire permet d'indiquer la liste des paramètres qui correspondent aux paramètres requis par le délégué delegatename. Vous devez mettre la liste des paramètres entre parenthèses. | |||
statements | Ce paramètre permet d'indiquer les instructions contenant les corps des méthodes AddHandler, RemoveHandler et RaiseEvent. | |||
End Event | Ce paramètre obligatoire permet d'indiquer la terminaison de bloc Event. |
Description
Ce mot réservé permet de déclarer un événement défini par l'utilisateur.
Remarques
- Une fois l'événement déclaré, utilisez l'instruction RaiseEvent pour déclencher l'événement.
- Vous pouvez déclarer des paramètres d'événement comme vous le faites pour des paramètres de procédures, avec les exceptions suivantes : les événements ne peuvent pas avoir de paramètres nommés, de paramètres ParamArray ou de paramètre facultatifs. Les événements n'ont pas de valeurs de retour.
- Pour gérer un événement, vous devez l'associer à un sous-programme de gestion d'événements à l'aide de l'instruction Handles ou AddHandler. Les signatures du sous-programme et de l'événement doivent correspondre. Pour gérer un événement partagé, vous devez utiliser l'instruction AddHandler.
- Vous ne pouvez utiliser Event qu'au niveau du module. Cela signifie que le contexte de déclaration d'un événement doit être une classe, une structure, un module ou une interface et ne peut pas être un fichier source, un espace de noms, une procédure ou un bloc.
Dernière mise à jour : Mardi, le 24 Août 2021