Expressions lambda (Visual Basic)Lambda Expressions (Visual Basic)

Une expression lambda est une fonction ou une sous-routine sans nom qui peut être utilisée partout où un délégué est valide.A lambda expression is a function or subroutine without a name that can be used wherever a delegate is valid. Les expressions lambda peuvent être des fonctions ou des sous-routines et peuvent être sur une ou plusieurs lignes.Lambda expressions can be functions or subroutines and can be single-line or multi-line. Vous pouvez passer des valeurs de la portée actuelle à une expression lambda.You can pass values from the current scope to a lambda expression.

Notes

L' RemoveHandler instruction est une exception.The RemoveHandler statement is an exception. Vous ne pouvez pas passer une expression lambda dans pour le paramètre RemoveHandlerde délégué de.You cannot pass a lambda expression in for the delegate parameter of RemoveHandler.

Vous créez des expressions lambda à l' Function aide Sub du mot clé ou, de la même façon que vous créez une fonction ou une sous-routine standard.You create lambda expressions by using the Function or Sub keyword, just as you create a standard function or subroutine. Toutefois, les expressions lambda sont incluses dans une instruction.However, lambda expressions are included in a statement.

L’exemple suivant est une expression lambda qui incrémente son argument et retourne la valeur.The following example is a lambda expression that increments its argument and returns the value. L’exemple montre la syntaxe d’expression lambda sur une seule ligne et sur plusieurs lignes pour une fonction.The example shows both the single-line and multi-line lambda expression syntax for a function.

Dim increment1 = Function(x) x + 1
Dim increment2 = Function(x)
                     Return x + 2
                 End Function

' Write the value 2.
Console.WriteLine(increment1(1))

' Write the value 4.
Console.WriteLine(increment2(2))

L’exemple suivant est une expression lambda qui écrit une valeur dans la console.The following example is a lambda expression that writes a value to the console. L’exemple montre la syntaxe de l’expression lambda sur une seule ligne et sur plusieurs lignes pour une sous-routine.The example shows both the single-line and multi-line lambda expression syntax for a subroutine.

Dim writeline1 = Sub(x) Console.WriteLine(x)
Dim writeline2 = Sub(x)
                     Console.WriteLine(x)
                 End Sub

' Write "Hello".
writeline1("Hello")

' Write "World"
writeline2("World")

Notez que dans les exemples précédents, les expressions lambda sont assignées à un nom de variable.Notice that in the previous examples the lambda expressions are assigned to a variable name. Chaque fois que vous faites référence à la variable, vous appelez l’expression lambda.Whenever you refer to the variable, you invoke the lambda expression. Vous pouvez également déclarer et appeler une expression lambda en même temps, comme illustré dans l’exemple suivant.You can also declare and invoke a lambda expression at the same time, as shown in the following example.

Console.WriteLine((Function(num As Integer) num + 1)(5))

Une expression lambda peut être retournée en tant que valeur d’un appel de fonction (comme indiqué dans l’exemple de la section Context plus loin dans cette rubrique) ou passée comme argument à un paramètre qui accepte un type délégué, comme indiqué dans l’exemple suivant.A lambda expression can be returned as the value of a function call (as is shown in the example in the Context section later in this topic), or passed in as an argument to a parameter that takes a delegate type, as shown in the following example.

Module Module2

    Sub Main()
        ' The following line will print Success, because 4 is even.
        testResult(4, Function(num) num Mod 2 = 0)
        ' The following line will print Failure, because 5 is not > 10.
        testResult(5, Function(num) num > 10)
    End Sub

    ' Sub testResult takes two arguments, an integer value and a 
    ' delegate function that takes an integer as input and returns
    ' a boolean. 
    ' If the function returns True for the integer argument, Success
    ' is displayed.
    ' If the function returns False for the integer argument, Failure
    ' is displayed.
    Sub testResult(ByVal value As Integer, ByVal fun As Func(Of Integer, Boolean))
        If fun(value) Then
            Console.WriteLine("Success")
        Else
            Console.WriteLine("Failure")
        End If
    End Sub

End Module

Syntaxe d’expression lambdaLambda Expression Syntax

La syntaxe d’une expression lambda ressemble à celle d’une fonction ou d’une sous-routine standard.The syntax of a lambda expression resembles that of a standard function or subroutine. Les différences sont les suivantes:The differences are as follows:

  • Une expression lambda n’a pas de nom.A lambda expression does not have a name.

  • Les expressions lambda ne peuvent pas avoir de modificateurs Overrides, tels que Overloads ou.Lambda expressions cannot have modifiers, such as Overloads or Overrides.

  • Les fonctions lambda sur une seule ligne n’utilisent As pas de clause pour désigner le type de retour.Single-line lambda functions do not use an As clause to designate the return type. Au lieu de cela, le type est déduit de la valeur à laquelle le corps de l’expression lambda correspond.Instead, the type is inferred from the value that the body of the lambda expression evaluates to. Par exemple, si le corps de l’expression lambda est cust.City = "London", son type de retour Booleanest.For example, if the body of the lambda expression is cust.City = "London", its return type is Boolean.

  • Dans les fonctions lambda sur plusieurs lignes, vous pouvez spécifier un type de retour à l' As aide d’une clause, As ou omettre la clause afin que le type de retour soit déduit.In multi-line lambda functions, you can either specify a return type by using an As clause, or omit the As clause so that the return type is inferred. Lorsque la As clause est omise pour une fonction lambda multiligne, le type de retour est déduit comme étant le type dominant de toutes les Return instructions dans la fonction lambda multiligne.When the As clause is omitted for a multi-line lambda function, the return type is inferred to be the dominant type from all the Return statements in the multi-line lambda function. Le type dominant est un type unique auquel tous les autres types peuvent s’étendre.The dominant type is a unique type that all other types can widen to. Si ce type unique ne peut pas être déterminé, le type dominant est le type unique auquel tous les autres types du tableau peuvent se limiter.If this unique type cannot be determined, the dominant type is the unique type that all other types in the array can narrow to. Si aucun de ces types uniques ne peut être déterminé, le type dominant est Object.If neither of these unique types can be determined, the dominant type is Object. Dans ce cas, si Option Strict a la Onvaleur, une erreur de compilateur se produit.In this case, if Option Strict is set to On, a compiler error occurs.

    Par exemple, si les expressions fournies à l' Return instruction contiennent des valeurs de Integertype Long, et Double, le tableau résultant est de type Double.For example, if the expressions supplied to the Return statement contain values of type Integer, Long, and Double, the resulting array is of type Double. Et s’étendent Double à et à uniquement Double. Integer LongBoth Integer and Long widen to Double and only Double. Par conséquent, Double est le type dominant.Therefore, Double is the dominant type. Pour plus d’informations, consultez Widening and Narrowing Conversions.For more information, see Widening and Narrowing Conversions.

  • Le corps d’une fonction sur une seule ligne doit être une expression qui retourne une valeur, et non une instruction.The body of a single-line function must be an expression that returns a value, not a statement. Il n’existe Return aucune instruction pour les fonctions à ligne unique.There is no Return statement for single-line functions. La valeur retournée par la fonction sur une seule ligne est la valeur de l’expression dans le corps de la fonction.The value returned by the single-line function is the value of the expression in the body of the function.

  • Le corps d’une sous-routine sur une seule ligne doit être une instruction sur une seule ligne.The body of a single-line subroutine must be single-line statement.

  • Les fonctions et sous-routines sur une seule ligne n' End Function incluent End Sub pas d’instruction ou.Single-line functions and subroutines do not include an End Function or End Sub statement.

  • Vous pouvez spécifier le type de données d’un paramètre d’expression lambda à As l’aide du mot clé, ou le type de données du paramètre peut être déduit.You can specify the data type of a lambda expression parameter by using the As keyword, or the data type of the parameter can be inferred. Tous les paramètres doivent avoir des types de données spécifiés ou tous doivent être déduits.Either all parameters must have specified data types or all must be inferred.

  • Optionalles Paramarray paramètres et ne sont pas autorisés.Optional and Paramarray parameters are not permitted.

  • Les paramètres génériques ne sont pas autorisés.Generic parameters are not permitted.

Lambdas asynchronesAsync Lambdas

Vous pouvez facilement créer des expressions et des instructions lambda qui incorporent le traitement asynchrone à l’aide des mots clés Async et await de l' opérateur .You can easily create lambda expressions and statements that incorporate asynchronous processing by using the Async and Await Operator keywords. Par exemple, l'exemple Windows Forms suivant contient un gestionnaire d'événements qui appelle et attend une méthode async ExampleMethodAsync.For example, the following Windows Forms example contains an event handler that calls and awaits an async method, ExampleMethodAsync.

Public Class Form1  
  
    Async Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click  
        ' ExampleMethodAsync returns a Task.  
        Await ExampleMethodAsync()  
        TextBox1.Text = vbCrLf & "Control returned to button1_Click."  
    End Sub  
  
    Async Function ExampleMethodAsync() As Task  
        ' The following line simulates a task-returning asynchronous process.  
        Await Task.Delay(1000)  
    End Function  
  
End Class  

Vous pouvez ajouter le même gestionnaire d’événements en utilisant une expression lambda asynchrone dans une instruction AddHandler.You can add the same event handler by using an async lambda in an AddHandler Statement. Pour ajouter ce gestionnaire, ajoutez un modificateur Async avant la liste des paramètres lambda, comme le montre l'exemple suivant.To add this handler, add an Async modifier before the lambda parameter list, as the following example shows.

Public Class Form1  
  
    Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load  
        AddHandler Button1.Click,   
            Async Sub(sender1, e1)  
                ' ExampleMethodAsync returns a Task.  
                Await ExampleMethodAsync()  
                TextBox1.Text = vbCrLf & "Control returned to Button1_ Click."  
            End Sub  
    End Sub  
  
    Async Function ExampleMethodAsync() As Task  
        ' The following line simulates a task-returning asynchronous process.  
        Await Task.Delay(1000)  
    End Function  
  
End Class  

Pour plus d’informations sur la création et l’utilisation des méthodes Async, consultez programmation asynchrone avec Async et await.For more information about how to create and use async methods, see Asynchronous Programming with Async and Await.

ContexteContext

Une expression lambda partage son contexte avec la portée dans laquelle elle est définie.A lambda expression shares its context with the scope within which it is defined. Il possède les mêmes droits d’accès que tout code écrit dans l’étendue contenante.It has the same access rights as any code written in the containing scope. Cela comprend l’accès aux variables membres, aux fonctions, Meaux Subs,, et aux paramètres et variables locales dans l’étendue contenante.This includes access to member variables, functions and subs, Me, and parameters and local variables in the containing scope.

L’accès aux variables locales et aux paramètres dans l’étendue contenante peut s’étendre au-delà de la durée de vie de cette étendue.Access to local variables and parameters in the containing scope can extend beyond the lifetime of that scope. Tant qu’un délégué qui fait référence à une expression lambda n’est pas disponible pour garbage collection, l’accès aux variables dans l’environnement d’origine est conservé.As long as a delegate referring to a lambda expression is not available to garbage collection, access to the variables in the original environment is retained. Dans l’exemple suivant, la target variable est locale makeTheGameà, la méthode dans laquelle l’expression playTheGame lambda est définie.In the following example, variable target is local to makeTheGame, the method in which the lambda expression playTheGame is defined. Notez que l’expression lambda retournée, assignée à takeAGuess dans Main, a toujours accès à targetla variable locale.Note that the returned lambda expression, assigned to takeAGuess in Main, still has access to the local variable target.

Module Module6

    Sub Main()
        ' Variable takeAGuess is a Boolean function. It stores the target
        ' number that is set in makeTheGame.
        Dim takeAGuess As gameDelegate = makeTheGame()

        ' Set up the loop to play the game.
        Dim guess As Integer
        Dim gameOver = False
        While Not gameOver
            guess = CInt(InputBox("Enter a number between 1 and 10 (0 to quit)", "Guessing Game", "0"))
            ' A guess of 0 means you want to give up.
            If guess = 0 Then
                gameOver = True
            Else
                ' Tests your guess and announces whether you are correct. Method takeAGuess
                ' is called multiple times with different guesses. The target value is not 
                ' accessible from Main and is not passed in.
                gameOver = takeAGuess(guess)
                Console.WriteLine("Guess of " & guess & " is " & gameOver)
            End If
        End While

    End Sub

    Delegate Function gameDelegate(ByVal aGuess As Integer) As Boolean

    Public Function makeTheGame() As gameDelegate

        ' Generate the target number, between 1 and 10. Notice that 
        ' target is a local variable. After you return from makeTheGame,
        ' it is not directly accessible.
        Randomize()
        Dim target As Integer = CInt(Int(10 * Rnd() + 1))

        ' Print the answer if you want to be sure the game is not cheating
        ' by changing the target at each guess.
        Console.WriteLine("(Peeking at the answer) The target is " & target)

        ' The game is returned as a lambda expression. The lambda expression
        ' carries with it the environment in which it was created. This 
        ' environment includes the target number. Note that only the current
        ' guess is a parameter to the returned lambda expression, not the target. 

        ' Does the guess equal the target?
        Dim playTheGame = Function(guess As Integer) guess = target

        Return playTheGame

    End Function

End Module

L’exemple suivant illustre la large gamme de droits d’accès de l’expression lambda imbriquée.The following example demonstrates the wide range of access rights of the nested lambda expression. Lorsque l’expression lambda retournée est exécutée aDelà partir de sous, elle accède à Main ces éléments:When the returned lambda expression is executed from Main as aDel, it accesses these elements:

  • Champ de la classe dans laquelle il est défini:aFieldA field of the class in which it is defined: aField

  • Une propriété de la classe dans laquelle elle est définie:aPropA property of the class in which it is defined: aProp

  • Paramètre de la méthode functionWithNestedLambda, dans lequel elle est définie:level1A parameter of method functionWithNestedLambda, in which it is defined: level1

  • Une variable functionWithNestedLambdalocale:localVarA local variable of functionWithNestedLambda: localVar

  • Paramètre de l’expression lambda dans laquelle il est imbriqué:level2A parameter of the lambda expression in which it is nested: level2

Module Module3

    Sub Main()
        ' Create an instance of the class, with 1 as the value of 
        ' the property.
        Dim lambdaScopeDemoInstance = 
            New LambdaScopeDemoClass With {.Prop = 1}

        ' Variable aDel will be bound to the nested lambda expression  
        ' returned by the call to functionWithNestedLambda.
        ' The value 2 is sent in for parameter level1.
        Dim aDel As aDelegate = 
            lambdaScopeDemoInstance.functionWithNestedLambda(2)

        ' Now the returned lambda expression is called, with 4 as the 
        ' value of parameter level3.
        Console.WriteLine("First value returned by aDel:   " & aDel(4))

        ' Change a few values to verify that the lambda expression has 
        ' access to the variables, not just their original values.
        lambdaScopeDemoInstance.aField = 20
        lambdaScopeDemoInstance.Prop = 30
        Console.WriteLine("Second value returned by aDel: " & aDel(40))
    End Sub

    Delegate Function aDelegate(
        ByVal delParameter As Integer) As Integer

    Public Class LambdaScopeDemoClass
        Public aField As Integer = 6
        Dim aProp As Integer

        Property Prop() As Integer
            Get
                Return aProp
            End Get
            Set(ByVal value As Integer)
                aProp = value
            End Set
        End Property

        Public Function functionWithNestedLambda(
            ByVal level1 As Integer) As aDelegate

            Dim localVar As Integer = 5

            ' When the nested lambda expression is executed the first 
            ' time, as aDel from Main, the variables have these values:
            ' level1 = 2
            ' level2 = 3, after aLambda is called in the Return statement
            ' level3 = 4, after aDel is called in Main
            ' localVar = 5
            ' aField = 6
            ' aProp = 1
            ' The second time it is executed, two values have changed:
            ' aField = 20
            ' aProp = 30
            ' level3 = 40
            Dim aLambda = Function(level2 As Integer) _
                              Function(level3 As Integer) _
                                  level1 + level2 + level3 + localVar +
                                    aField + aProp

            ' The function returns the nested lambda, with 3 as the 
            ' value of parameter level2.
            Return aLambda(3)
        End Function

    End Class
End Module

Convertir en un type déléguéConverting to a Delegate Type

Une expression lambda peut être implicitement convertie en un type délégué compatible.A lambda expression can be implicitly converted to a compatible delegate type. Pour plus d’informations sur les exigences générales en matière de compatibilité, consultez la section conversion souple des délégués.For information about the general requirements for compatibility, see Relaxed Delegate Conversion. Par exemple, l’exemple de code suivant montre une expression lambda qui convertit implicitement en Func(Of Integer, Boolean) ou une signature de délégué correspondante.For example, the following code example shows a lambda expression that implicitly converts to Func(Of Integer, Boolean) or a matching delegate signature.

' Explicitly specify a delegate type.
Delegate Function MultipleOfTen(ByVal num As Integer) As Boolean

' This function matches the delegate type.
Function IsMultipleOfTen(ByVal num As Integer) As Boolean
    Return num Mod 10 = 0
End Function

' This method takes an input parameter of the delegate type. 
' The checkDelegate parameter could also be of 
' type Func(Of Integer, Boolean).
Sub CheckForMultipleOfTen(ByVal values As Integer(),
                          ByRef checkDelegate As MultipleOfTen)
    For Each value In values
        If checkDelegate(value) Then
            Console.WriteLine(value & " is a multiple of ten.")
        Else
            Console.WriteLine(value & " is not a multiple of ten.")
        End If
    Next
End Sub

' This method shows both an explicitly defined delegate and a
' lambda expression passed to the same input parameter.
Sub CheckValues()
    Dim values = {5, 10, 11, 20, 40, 30, 100, 3}
    CheckForMultipleOfTen(values, AddressOf IsMultipleOfTen)
    CheckForMultipleOfTen(values, Function(num) num Mod 10 = 0)
End Sub

L’exemple de code suivant montre une expression lambda qui convertit implicitement en Sub(Of Double, String, Double) ou une signature de délégué correspondante.The following code example shows a lambda expression that implicitly converts to Sub(Of Double, String, Double) or a matching delegate signature.

Module Module1
    Delegate Sub StoreCalculation(ByVal value As Double,
                                  ByVal calcType As String,
                                  ByVal result As Double)

    Sub Main()
        ' Create a DataTable to store the data.
        Dim valuesTable = New DataTable("Calculations")
        valuesTable.Columns.Add("Value", GetType(Double))
        valuesTable.Columns.Add("Calculation", GetType(String))
        valuesTable.Columns.Add("Result", GetType(Double))

        ' Define a lambda subroutine to write to the DataTable.
        Dim writeToValuesTable = Sub(value As Double, calcType As String, result As Double)
                                     Dim row = valuesTable.NewRow()
                                     row(0) = value
                                     row(1) = calcType
                                     row(2) = result
                                     valuesTable.Rows.Add(row)
                                 End Sub

        ' Define the source values.
        Dim s = {1, 2, 3, 4, 5, 6, 7, 8, 9}

        ' Perform the calculations.
        Array.ForEach(s, Sub(c) CalculateSquare(c, writeToValuesTable))
        Array.ForEach(s, Sub(c) CalculateSquareRoot(c, writeToValuesTable))

        ' Display the data.
        Console.WriteLine("Value" & vbTab & "Calculation" & vbTab & "Result")
        For Each row As DataRow In valuesTable.Rows
            Console.WriteLine(row(0).ToString() & vbTab &
                              row(1).ToString() & vbTab &
                              row(2).ToString())
        Next

    End Sub


    Sub CalculateSquare(ByVal number As Double, ByVal writeTo As StoreCalculation)
        writeTo(number, "Square     ", number ^ 2)
    End Sub

    Sub CalculateSquareRoot(ByVal number As Double, ByVal writeTo As StoreCalculation)
        writeTo(number, "Square Root", Math.Sqrt(number))
    End Sub
End Module

Quand vous assignez des expressions lambda à des délégués ou les passez comme arguments à des procédures, vous pouvez spécifier les noms des paramètres, mais omettre leurs types de données, ce qui permet aux types d’être extraits du délégué.When you assign lambda expressions to delegates or pass them as arguments to procedures, you can specify the parameter names but omit their data types, letting the types be taken from the delegate.

ExemplesExamples

  • L’exemple suivant définit une expression lambda qui retourne True si l’argument Nullable a une valeur assignée False , et si sa Nothingvaleur est.The following example defines a lambda expression that returns True if the nullable argument has an assigned value, and False if its value is Nothing.

    Dim notNothing =
      Function(num? As Integer) num IsNot Nothing
    Dim arg As Integer = 14
    Console.WriteLine("Does the argument have an assigned value?")
    Console.WriteLine(notNothing(arg))
    
  • L’exemple suivant définit une expression lambda qui retourne l’index du dernier élément d’un tableau.The following example defines a lambda expression that returns the index of the last element in an array.

    Dim numbers() = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}
    Dim lastIndex =
      Function(intArray() As Integer) intArray.Length - 1
    For i = 0 To lastIndex(numbers)
        numbers(i) += 1
    Next
    

Voir aussiSee also