ラムダ式 (Visual Basic)Lambda Expressions (Visual Basic)

ラムダ式は、デリゲートが有効な場所であれば使用できる名前のない関数またはサブルーチンです。A lambda expression is a function or subroutine without a name that can be used wherever a delegate is valid. ラムダ式は関数またはサブルーチンにすることができ、単一行または複数行にすることができます。Lambda expressions can be functions or subroutines and can be single-line or multi-line. 現在のスコープからラムダ式に値を渡すことができます。You can pass values from the current scope to a lambda expression.

注意

RemoveHandlerステートメントは例外です。The RemoveHandler statement is an exception. RemoveHandlerデリゲートパラメーターに対してラムダ式を渡すことはできません。You cannot pass a lambda expression in for the delegate parameter of RemoveHandler.

ラムダ式を作成するにFunctionは、標準の関数またはサブルーチンを作成する場合と同様に、キーワードまたはSubキーワードを使用します。You create lambda expressions by using the Function or Sub keyword, just as you create a standard function or subroutine. ただし、ラムダ式はステートメントに含まれています。However, lambda expressions are included in a statement.

次の例は、引数をインクリメントして値を返すラムダ式です。The following example is a lambda expression that increments its argument and returns the value. この例では、関数の単一行と複数行のラムダ式の構文の両方を示しています。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))

次の例は、値をコンソールに書き込むラムダ式です。The following example is a lambda expression that writes a value to the console. この例では、サブルーチンの単一行と複数行のラムダ式の構文の両方を示しています。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")

前の例では、ラムダ式は変数名に割り当てられていることに注意してください。Notice that in the previous examples the lambda expressions are assigned to a variable name. 変数を参照するときは常に、ラムダ式を呼び出します。Whenever you refer to the variable, you invoke the lambda expression. 次の例に示すように、同時にラムダ式を宣言して呼び出すこともできます。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))

ラムダ式は、次の例に示すように、関数呼び出しの値として返すことができます (このトピックで後述するコンテキストセクションの例に示すように)。または、デリゲート型を受け取るパラメーターに引数として渡されます。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

ラムダ式の構文Lambda Expression Syntax

ラムダ式の構文は、標準の関数またはサブルーチンの構文に似ています。The syntax of a lambda expression resembles that of a standard function or subroutine. 違いは次のとおりです。The differences are as follows:

  • ラムダ式に名前がありません。A lambda expression does not have a name.

  • ラムダ式にOverloadsは、やOverridesなどの修飾子を含めることはできません。Lambda expressions cannot have modifiers, such as Overloads or Overrides.

  • 単一行のラムダ関数は、 As句を使用して戻り値の型を指定することはありません。Single-line lambda functions do not use an As clause to designate the return type. 代わりに、ラムダ式の本体が評価される値から型が推論されます。Instead, the type is inferred from the value that the body of the lambda expression evaluates to. たとえば、ラムダ式の本体がcust.City = "London"の場合、その戻り値の型はBooleanになります。For example, if the body of the lambda expression is cust.City = "London", its return type is Boolean.

  • 複数行のラムダ関数では、 As句を使用して戻り値の型を指定することも、戻り値の型が推論されるようにAs句を省略することもできます。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. 複数行のラムダ関数に対してReturn 句を省略した場合、戻り値の型は、複数行のラムダ関数内のすべてのステートメントから最も優先的な型になります。AsWhen 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. 最も優先されるは、他のすべての型の幅を広げることができる一意の型です。The dominant type is a unique type that all other types can widen to. この一意の型を特定できない場合、最も優先される型は、配列内の他のすべての型を絞り込むことができる一意の型になります。If this unique type cannot be determined, the dominant type is the unique type that all other types in the array can narrow to. これらの一意の型をどちらも特定できない場合は、 Objectが最も優先度の高い型になります。If neither of these unique types can be determined, the dominant type is Object. この場合、がにOption Strict On設定されていると、コンパイラエラーが発生します。In this case, if Option Strict is set to On, a compiler error occurs.

    たとえばReturn 、ステートメントに指定された式に、 Long、、およびInteger Double型の値が含まれている場合、 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. Integer Double の両方Doubleがに拡大変換されます。 LongBoth Integer and Long widen to Double and only Double. そのため、 Double が最も優先度の高い型になります。Therefore, Double is the dominant type. 詳細については、「 Widening and Narrowing Conversions」を参照してください。For more information, see Widening and Narrowing Conversions.

  • 単一行関数の本体は、ステートメントではなく、値を返す式である必要があります。The body of a single-line function must be an expression that returns a value, not a statement. 単一行関数Returnのステートメントはありません。There is no Return statement for single-line functions. 単一行関数によって返される値は、関数本体の式の値です。The value returned by the single-line function is the value of the expression in the body of the function.

  • 単一行のサブルーチンの本体は単一行ステートメントである必要があります。The body of a single-line subroutine must be single-line statement.

  • 単一行関数とサブルーチンには、 End FunctionステートメントまたはEnd Subステートメントは含まれません。Single-line functions and subroutines do not include an End Function or End Sub statement.

  • ラムダ式のパラメーターのデータ型は、 Asキーワードを使用して指定できます。また、パラメーターのデータ型を推論することもできます。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. すべてのパラメーターのデータ型が指定されているか、すべてのパラメーターが推論される必要があります。Either all parameters must have specified data types or all must be inferred.

  • Optionalパラメーター Paramarrayとパラメーターは使用できません。Optional and Paramarray parameters are not permitted.

  • ジェネリックパラメーターは使用できません。Generic parameters are not permitted.

非同期ラムダAsync Lambdas

AsyncおよびAwait 演算子キーワードを使用して、非同期処理を組み込むラムダ式およびステートメントを簡単に作成できます。You can easily create lambda expressions and statements that incorporate asynchronous processing by using the Async and Await Operator keywords. たとえば、次に示す Windows フォーム例には、非同期メソッド 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  

AddHandler ステートメントで非同期ラムダを使用して、同じイベントハンドラーを追加できます。You can add the same event handler by using an async lambda in an AddHandler Statement. 次の例に示すように、このハンドラーを追加するには、ラムダ パラメーター リストの前に Async 修飾子を追加します。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  

非同期メソッドを作成して使用する方法の詳細については、「 async および Await を使用した非同期プログラミング」を参照してください。For more information about how to create and use async methods, see Asynchronous Programming with Async and Await.

関連Context

ラムダ式は、そのコンテキストを定義されているスコープと共有します。A lambda expression shares its context with the scope within which it is defined. コンテナースコープで記述されたコードと同じアクセス権を持っています。It has the same access rights as any code written in the containing scope. これには、コンテナースコープ内のメンバー変数、 Me関数、および sub、、およびパラメーターとローカル変数へのアクセスが含まれます。This includes access to member variables, functions and subs, Me, and parameters and local variables in the containing scope.

外側のスコープ内のローカル変数とパラメーターへのアクセスは、そのスコープの有効期間を超えて拡張できます。Access to local variables and parameters in the containing scope can extend beyond the lifetime of that scope. ラムダ式を参照するデリゲートがガベージコレクションに使用できない限り、元の環境の変数へのアクセスは保持されます。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. 次の例では、 target変数は、 makeTheGameラムダ式playTheGameが定義されているメソッドであるに対してローカルです。In the following example, variable target is local to makeTheGame, the method in which the lambda expression playTheGame is defined. 返されたラムダ式は、のtakeAGuess Mainに割り当てられていますが、ローカルtarget変数には引き続きアクセスできます。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

次の例は、入れ子になったラムダ式の幅広いアクセス権を示しています。The following example demonstrates the wide range of access rights of the nested lambda expression. 返されたラムダ式が as Main aDelから実行されると、次の要素にアクセスします。When the returned lambda expression is executed from Main as aDel, it accesses these elements:

  • 定義されているクラスのフィールド:aFieldA field of the class in which it is defined: aField

  • 定義されているクラスのプロパティ:aPropA property of the class in which it is defined: aProp

  • メソッドfunctionWithNestedLambdaのパラメーター。定義されています。level1A parameter of method functionWithNestedLambda, in which it is defined: level1

  • ローカル変数functionWithNestedLambda:localVarA local variable of functionWithNestedLambda: localVar

  • 入れ子になっているラムダ式のパラメーター。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

デリゲート型への変換Converting to a Delegate Type

ラムダ式は、互換性のあるデリゲート型に暗黙的に変換できます。A lambda expression can be implicitly converted to a compatible delegate type. 互換性に関する一般的な要件の詳細については、「厳密でないデリゲート変換」を参照してください。For information about the general requirements for compatibility, see Relaxed Delegate Conversion. たとえば、次のコード例は、または一致するデリゲートシグネチャにFunc(Of Integer, Boolean)暗黙的に変換されるラムダ式を示しています。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

次のコード例は、または一致するデリゲートシグネチャSub(Of Double, String, Double)に暗黙的に変換されるラムダ式を示しています。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

デリゲートにラムダ式を割り当てたり、プロシージャに引数として渡したりする場合は、パラメーター名を指定し、データ型を省略して、デリゲートから型を取得することができます。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.

使用例Examples

  • 次の例では、null 許容型Trueの引数に値が割り当てられてFalseいる場合はを返しNothing、値がの場合はを返すラムダ式を定義します。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))
    
  • 次の例では、配列内の最後の要素のインデックスを返すラムダ式を定義します。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
    

関連項目See also