Délégués (Visual Basic)Delegates (Visual Basic)

Les délégués sont des objets qui font référence à des méthodes.Delegates are objects that refer to methods. Ils sont parfois décrits comme des pointeurs de fonction de type sécurisé, car ils sont comparables aux pointeurs de fonction utilisés dans d’autres langages de programmation.They are sometimes described as type-safe function pointers because they are similar to function pointers used in other programming languages. Mais contrairement aux pointeurs de fonction, les délégués de Visual Basic sont un type de référence basé sur la classe System.Delegate.But unlike function pointers, Visual Basic delegates are a reference type based on the class System.Delegate. Les délégués peuvent faire référence à des méthodes partagées (méthodes qui peuvent être appelées sans une instance spécifique de classe) et des méthodes d’instance.Delegates can reference both shared methods — methods that can be called without a specific instance of a class — and instance methods.

Délégués et événementsDelegates and Events

Les délégués sont utiles dans les situations où un intermédiaire est nécessaire entre une procédure appelante et la procédure appelée.Delegates are useful in situations where you need an intermediary between a calling procedure and the procedure being called. Par exemple, vous pouvez créer un objet qui déclenche des événements pour pouvoir appeler différents gestionnaires d’événements dans différentes circonstances.For example, you might want an object that raises events to be able to call different event handlers under different circumstances. Malheureusement, l’objet qui déclenche les événements ne peut pas savoir à l’avance quel gestionnaire d’événements gère un événement donné.Unfortunately, the object raising the events cannot know ahead of time which event handler is handling a specific event. Visual Basic vous permet de gestionnaires d’événements associer de façon dynamique avec des événements en créant un délégué pour vous lorsque vous utilisez la AddHandler instruction.Visual Basic lets you dynamically associate event handlers with events by creating a delegate for you when you use the AddHandler statement. À l’exécution, le délégué transmet les appels au gestionnaire d’événements approprié.At run time, the delegate forwards calls to the appropriate event handler.

Bien que vous pouvez créer vos propres délégués, dans la plupart des cas, Visual Basic crée le délégué et s’occupe des détails pour vous.Although you can create your own delegates, in most cases Visual Basic creates the delegate and takes care of the details for you. Par exemple, une instruction Event définit implicitement une classe déléguée nommée <EventName>EventHandler comme classe imbriquée de la classe contenant l’instruction Event, avec la même signature que l’événement.For example, an Event statement implicitly defines a delegate class named <EventName>EventHandler as a nested class of the class containing the Event statement, and with the same signature as the event. L’instruction AddressOf crée implicitement une instance d’un délégué qui fait référence à une procédure spécifique.The AddressOf statement implicitly creates an instance of a delegate that refers to a specific procedure. Les deux lignes de code suivantes sont équivalentes.The following two lines of code are equivalent. Dans la première ligne, vous voyez la création explicite d’une instance de EventHandler, avec une référence à la méthode Button1_Click envoyée comme argument.In the first line, you see the explicit creation of an instance of EventHandler, with a reference to method Button1_Click sent as the argument. La deuxième ligne est un moyen plus commode de faire la même chose.The second line is a more convenient way to do the same thing.

AddHandler Button1.Click, New EventHandler(AddressOf Button1_Click)
' The following line of code is shorthand for the previous line.
AddHandler Button1.Click, AddressOf Me.Button1_Click

Vous pouvez utiliser la syntaxe raccourcie pour créer des délégués dès l’instant où le compilateur peut déterminer le type du délégué par le contexte.You can use the shorthand way of creating delegates anywhere the compiler can determine the delegate's type by the context.

Déclaration d’événements utilisant un type délégué existantDeclaring Events that Use an Existing Delegate Type

Dans certaines situations, vous souhaiterez peut-être déclarer un événement pour utiliser un type délégué existant comme son délégué sous-jacent.In some situations, you may want to declare an event to use an existing delegate type as its underlying delegate. La syntaxe suivante montre comment :The following syntax demonstrates how:

Delegate Sub DelegateType()
Event AnEvent As DelegateType

C’est utile pour acheminer plusieurs événements vers le même gestionnaire.This is useful when you want to route multiple events to the same handler.

Paramètres et variables déléguésDelegate Variables and Parameters

Vous pouvez utiliser des délégués pour d’autres tâches non liées aux événements, telles que le threading libre, ou avec des procédures qui doivent appeler différentes versions de fonctions à l’exécution.You can use delegates for other, non-event related tasks, such as free threading or with procedures that need to call different versions of functions at run time.

Par exemple, supposons que vous disposez d’une application de petites annonces qui comprend une zone de liste avec les noms de voitures.For example, suppose you have a classified-ad application that includes a list box with the names of cars. Les annonces sont triées par titre, qui correspond normalement à la marque de la voiture.The ads are sorted by title, which is normally the make of the car. Vous pouvez rencontrer le cas de figure où certaines voitures indiquent l’année de la voiture avant la marque.A problem you may face occurs when some cars include the year of the car before the make. Le problème est que la fonctionnalité de tri prédéfinie de la zone de liste trie seulement par code de caractères ; elle place en premier toutes les annonces qui commencent par une date, suivies des annonces qui commencent par la marque.The problem is that the built-in sort functionality of the list box sorts only by character codes; it places all the ads starting with dates first, followed by the ads starting with the make.

Pour résoudre ce problème, vous pouvez créer une procédure de tri dans une classe qui utilise le tri alphabétique standard sur la plupart des zones de liste, mais qui est capable, à l’exécution, de passer à la procédure de tri personnalisé pour les annonces de voiture.To fix this, you can create a sort procedure in a class that uses the standard alphabetic sort on most list boxes, but is able to switch at run time to the custom sort procedure for car ads. Pour ce faire, transmettez la procédure de tri personnalisée à la classe de tri à l’exécution, à l’aide de délégués.To do this, you pass the custom sort procedure to the sort class at run time, using delegates.

Expressions lambda et AddressOfAddressOf and Lambda Expressions

Chaque classe déléguée définit un constructeur auquel les caractéristiques d’une méthode objet sont passées.Each delegate class defines a constructor that is passed the specification of an object method. L’argument d’un constructeur délégué doit être une référence à une méthode ou une expression lambda.An argument to a delegate constructor must be a reference to a method, or a lambda expression.

Pour spécifier une référence à une méthode, utilisez la syntaxe suivante :To specify a reference to a method, use the following syntax:

AddressOf [expression.]methodNameAddressOf [expression.]methodName

Le type de compilation de expression doit être le nom d’une classe ou d’une interface qui contient une méthode portant le nom spécifié, dont la signature corresponde à celle de la classe déléguée.The compile-time type of the expression must be the name of a class or an interface that contains a method of the specified name whose signature matches the signature of the delegate class. La méthode methodName peut être une méthode partagée ou d’instance.The methodName can be either a shared method or an instance method. methodName n’est pas facultatif, même si l’on crée un délégué pour la méthode par défaut de la classe.The methodName is not optional, even if you create a delegate for the default method of the class.

Pour spécifier une expression lambda, utilisez la syntaxe suivante :To specify a lambda expression, use the following syntax:

Function ([parm As type, parm2 As type2, ...]) expressionFunction ([parm As type, parm2 As type2, ...]) expression

L’exemple suivant illustre les expressions lambda et AddressOf utilisées pour spécifier la référence d’un délégué.The following example shows both AddressOf and lambda expressions used to specify the reference for a delegate.

Module Module1

    Sub Main()
        ' Create an instance of InOrderClass and assign values to the properties.
        ' InOrderClass method ShowInOrder displays the numbers in ascending 
        ' or descending order, depending on the comparison method you specify.
        Dim inOrder As New InOrderClass
        inOrder.Num1 = 5
        inOrder.Num2 = 4

        ' Use AddressOf to send a reference to the comparison function you want
        ' to use.
        inOrder.ShowInOrder(AddressOf GreaterThan)
        inOrder.ShowInOrder(AddressOf LessThan)

        ' Use lambda expressions to do the same thing.
        inOrder.ShowInOrder(Function(m, n) m > n)
        inOrder.ShowInOrder(Function(m, n) m < n)
    End Sub

    Function GreaterThan(ByVal num1 As Integer, ByVal num2 As Integer) As Boolean
        Return num1 > num2
    End Function

    Function LessThan(ByVal num1 As Integer, ByVal num2 As Integer) As Boolean
        Return num1 < num2
    End Function

    Class InOrderClass
        ' Define the delegate function for the comparisons.
        Delegate Function CompareNumbers(ByVal num1 As Integer, ByVal num2 As Integer) As Boolean
        ' Display properties in ascending or descending order.
        Sub ShowInOrder(ByVal compare As CompareNumbers)
            If compare(_num1, _num2) Then
                Console.WriteLine(_num1 & "  " & _num2)
            Else
                Console.WriteLine(_num2 & "  " & _num1)
            End If
        End Sub

        Private _num1 As Integer
        Property Num1() As Integer
            Get
                Return _num1
            End Get
            Set(ByVal value As Integer)
                _num1 = value
            End Set
        End Property

        Private _num2 As Integer
        Property Num2() As Integer
            Get
                Return _num2
            End Get
            Set(ByVal value As Integer)
                _num2 = value
            End Set
        End Property
    End Class
End Module

La signature de la fonction doit correspondre à celle du type délégué.The signature of the function must match that of the delegate type. Pour plus d’informations sur les expressions lambda, consultez Expressions Lambda.For more information about lambda expressions, see Lambda Expressions. Pour voir plus d’exemples d’affectation d’expressions lambda et AddressOf aux délégués, consultez la page Conversion souple des délégués.For more examples of lambda expression and AddressOf assignments to delegates, see Relaxed Delegate Conversion.

TitreTitle DescriptionDescription
Guide pratique pour Appeler une méthode déléguéeHow to: Invoke a Delegate Method Fournit un exemple d’association d’une méthode à un délégué, puis d’appel de cette méthode par le biais du délégué.Provides an example that shows how to associate a method with a delegate and then invoke that method through the delegate.
Guide pratique pour Passer des procédures à une autre procédure en Visual BasicHow to: Pass Procedures to Another Procedure in Visual Basic Montre comment utiliser des délégués pour transmettre une procédure à une autre procédure.Demonstrates how to use delegates to pass one procedure to another procedure.
Conversion simplifiée des déléguésRelaxed Delegate Conversion Explique comment affecter des sous-routines et des fonctions aux délégués ou aux gestionnaires même si leurs signatures ne sont pas identiques.Describes how you can assign subs and functions to delegates or handlers even when their signatures are not identical
ÉvénementsEvents Fournit une vue d’ensemble des événements en Visual Basic.Provides an overview of events in Visual Basic.