Lambda-uttryck (Visual Basic)

Ett lambda-uttryck är en funktion eller underrutin utan ett namn som kan användas varhelst ett ombud är giltigt. Lambda-uttryck kan vara funktioner eller subrutiner och kan vara enrads- eller flerradsuttryck. Du kan skicka värden från det aktuella omfånget till ett lambda-uttryck.

Kommentar

-instruktionen RemoveHandler är ett undantag. Du kan inte skicka in ett lambda-uttryck för delegatparametern RemoveHandler.

Du skapar lambda-uttryck med hjälp av nyckelordet Function eller Sub på samma sätt som du skapar en standardfunktion eller underrutin. Lambda-uttryck ingår dock i en -instruktion.

Följande exempel är ett lambda-uttryck som ökar argumentet och returnerar värdet. Exemplet visar både lambda-uttryckssyntaxen för en enskild rad och flera rader för en funktion.

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))

Följande exempel är ett lambda-uttryck som skriver ett värde till konsolen. Exemplet visar både lambda-uttryckssyntaxen för en enskild rad och flera rader för en subrutin.

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

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

' Write "World"
writeline2("World")

Observera att lambda-uttrycken i föregående exempel tilldelas till ett variabelnamn. När du refererar till variabeln anropar du lambda-uttrycket. Du kan också deklarera och anropa ett lambda-uttryck samtidigt, som du ser i följande exempel.

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

Ett lambda-uttryck kan returneras som värdet för ett funktionsanrop (som visas i exemplet i avsnittet Kontext senare i det här avsnittet) eller skickas som ett argument till en parameter som tar en ombudstyp, som du ser i följande exempel.

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

Lambda-uttryckssyntax

Syntaxen för ett lambda-uttryck liknar syntaxen för en standardfunktion eller underrutin. Skillnaderna är följande:

• Ett lambda-uttryck har inget namn.

• Lambda-uttryck kan inte ha modifierare, till exempel Overloads eller Overrides.

• Lambda-funktioner med en rad använder inte en As sats för att ange returtypen. I stället härleds typen från det värde som lambda-uttryckets brödtext utvärderas till. Om till exempel lambda-uttryckets brödtext är cust.City = "London"är Booleandess returtyp .

• I lambda-funktioner med flera rader kan du antingen ange en returtyp med hjälp av en As sats eller utelämna As satsen så att returtypen härleds. As När satsen utelämnas för en lambda-funktion med flera rader, anses returtypen vara den dominerande typen från alla Return instruktioner i funktionen lambda med flera rader. Den dominerande typen är en unik typ som alla andra typer kan utvidgas till. Om den här unika typen inte kan fastställas är den dominerande typen den unika typ som alla andra typer i matrisen kan begränsas till. Om ingen av dessa unika typer kan fastställas är Objectden dominerande typen . I det här fallet, om Option Strict är inställt på On, uppstår ett kompilatorfel.

  Om de uttryck som anges i -instruktionen Return till exempel innehåller värden av typen Integer, Longoch Double, är den resulterande matrisen av typen Double. Både Integer och Long vidgas till Double och endast Double. Double Därför är den dominerande typen. Mer information finns i Widening and Narrowing Conversions (Bredda och begränsa konverteringar).

• Brödtexten för en enradsfunktion måste vara ett uttryck som returnerar ett värde, inte en -instruktion. Det finns ingen Return instruktion för enradsfunktioner. Värdet som returneras av enradsfunktionen är värdet för uttrycket i funktionens brödtext.

• Brödtexten för en enradsunderrutin måste vara enradsinstruktur.

• Enradsfunktioner och subrutiner innehåller inte en End Function -instruktion End Sub .

• Du kan ange datatypen för en lambda-uttrycksparameter med hjälp av nyckelordet As , eller så kan du härleda parameterns datatyp. Antingen måste alla parametrar ha angivna datatyper eller så måste alla härledas.

• Optional och Paramarray parametrar tillåts inte.

• Allmänna parametrar är inte tillåtna.

Async Lambdas

Du kan enkelt skapa lambda-uttryck och -instruktioner som innehåller asynkron bearbetning med hjälp av nyckelorden Async och Await Operator . Följande Windows Forms-exempel innehåller till exempel en händelsehanterare som anropar och väntar på en asynkron metod, 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

Du kan lägga till samma händelsehanterare med hjälp av en asynkron lambda i en AddHandler-instruktion. Lägg till den här hanteraren genom att lägga till en Async modifierare före lambda-parameterlistan, vilket visas i följande exempel.

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

Mer information om hur du skapar och använder asynkrona metoder finns i Asynkron programmering med Async och Await.

Kontext

Ett lambda-uttryck delar sin kontext med det omfång inom vilket det definieras. Den har samma åtkomsträttigheter som all kod som skrivits i det innehållande omfånget. Detta omfattar åtkomst till medlemsvariabler, funktioner och subs, Meoch parametrar och lokala variabler i det innehållande omfånget.

Åtkomsten till lokala variabler och parametrar i det innehållande omfånget kan sträcka sig längre än livslängden för det omfånget. Så länge ett ombud som refererar till ett lambda-uttryck inte är tillgängligt för skräpinsamling behålls åtkomsten till variablerna i den ursprungliga miljön. I följande exempel är variabeln target lokal för makeTheGame, metoden där lambda-uttrycket playTheGame definieras. Observera att det returnerade lambda-uttrycket, som tilldelats takeAGuess i Main, fortfarande har åtkomst till den lokala variabeln 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

I följande exempel visas det breda utbudet av åtkomsträttigheter för det kapslade lambda-uttrycket. När det returnerade lambda-uttrycket körs från Main som aDelkommer det åt följande element:

• Ett fält i klassen där den definieras: aField

• En egenskap för klassen där den definieras: aProp

• En parameter för metoden functionWithNestedLambda, där den definieras: level1

• En lokal variabel för functionWithNestedLambda: localVar

• En parameter för lambda-uttrycket där det är kapslat: 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

Konvertera till en ombudstyp

Ett lambda-uttryck kan implicit konverteras till en kompatibel ombudstyp. Information om de allmänna kraven för kompatibilitet finns i Avslappnad delegatkonvertering. I följande kodexempel visas till exempel ett lambda-uttryck som implicit konverteras till Func(Of Integer, Boolean) eller en matchande ombudssignatur.

' 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

I följande kodexempel visas ett lambda-uttryck som implicit konverteras till Sub(Of Double, String, Double) eller en matchande ombudssignatur.

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

När du tilldelar lambda-uttryck till ombud eller skickar dem som argument till procedurer kan du ange parameternamnen men utelämna deras datatyper, så att typerna kan tas från ombudet.

Exempel

• I följande exempel definieras ett lambda-uttryck som returnerar True om argumentet nullable value type har ett tilldelat värde och False om dess värde är 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))
  

• I följande exempel definieras ett lambda-uttryck som returnerar indexet för det sista elementet i en matris.

  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
  

Se även

• Förfaranden
• Introduktion till LINQ i Visual Basic
• Delegater
• Funktionsuttryck
• Underuttryck
• Typer av null-värden
• Anvisningar: Skicka procedurer till en annan procedur i Visual Basic
• Gör så här: Skapa ett Lambda-uttryck
• Avslappnad delegatkonvertering