任務平行庫(TPL)包含許多方法,採用其中一個 System.Func<TResult> 或 System.Action 系列委派作為輸入參數。 您可以使用這些委派,將自定義程式邏輯傳遞至平行迴圈、工作或查詢。 TPL 和 PLINQ 的程式代碼範例會使用 Lambda 運算式,將這些委派的實例建立為內嵌程式代碼區塊。 本主題提供 Func 和 Action 的簡短簡介,並示範如何在工作平行連結庫和 PLINQ 中使用 Lambda 表達式。
備註
如需一般委派的詳細資訊,請參閱 委派 和 委派。 如需 C# 和 Visual Basic 中 Lambda 表達式的詳細資訊,請參閱 Lambda 運算式 和 Lambda 運算式。
Func 委派類型
Func
委派封裝了一個傳回值的方法。 在 Func
簽章中,最後一個或最右邊的類型參數一律會指定傳回類型。 編譯程式錯誤的其中一個常見原因是嘗試將兩個輸入參數傳遞至 System.Func<T,TResult>;事實上,此類型只接受一個輸入參數。 .NET 定義了 17 個版本的 Func
:System.Func<TResult>、System.Func<T,TResult>、System.Func<T1,T2,TResult>,一直到 System.Func<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,TResult>。
動作代理
System.Action 委派會封裝不會傳回值的方法(Visual Basic 中的 Sub)。 在 Action
類型簽章中,類型參數只代表輸入參數。 和 Func
一樣,.NET 會從沒有類型參數的版本定義 17 個版本的 Action
。從沒有類型參數的版本,到具有 16 個類型參數的版本。
範例
下列 Parallel.ForEach<TSource,TLocal>(IEnumerable<TSource>, Func<TLocal>, Func<TSource,ParallelLoopState,TLocal,TLocal>, Action<TLocal>) 方法範例示範如何使用 Lambda 表達式來表達 Func 和 Action 委派。
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
class ForEachWithThreadLocal
{
// Demonstrated features:
// Parallel.ForEach()
// Thread-local state
// Expected results:
// This example sums up the elements of an int[] in parallel.
// Each thread maintains a local sum. When a thread is initialized, that local sum is set to 0.
// On every iteration the current element is added to the local sum.
// When a thread is done, it safely adds its local sum to the global sum.
// After the loop is complete, the global sum is printed out.
// Documentation:
// http://msdn.microsoft.com/library/dd990270(VS.100).aspx
static void Main()
{
// The sum of these elements is 40.
int[] input = { 4, 1, 6, 2, 9, 5, 10, 3 };
int sum = 0;
try
{
Parallel.ForEach(
input, // source collection
() => 0, // thread local initializer
(n, loopState, localSum) => // body
{
localSum += n;
Console.WriteLine("Thread={0}, n={1}, localSum={2}", Thread.CurrentThread.ManagedThreadId, n, localSum);
return localSum;
},
(localSum) => Interlocked.Add(ref sum, localSum) // thread local aggregator
);
Console.WriteLine($"\nSum={sum}");
}
// No exception is expected in this example, but if one is still thrown from a task,
// it will be wrapped in AggregateException and propagated to the main thread.
catch (AggregateException e)
{
Console.WriteLine($"Parallel.ForEach has thrown an exception. THIS WAS NOT EXPECTED.\n{e}");
}
}
}
Imports System.Threading
Imports System.Threading.Tasks
Module ForEachDemo
' Demonstrated features:
' Parallel.ForEach()
' Thread-local state
' Expected results:
' This example sums up the elements of an int[] in parallel.
' Each thread maintains a local sum. When a thread is initialized, that local sum is set to 0.
' On every iteration the current element is added to the local sum.
' When a thread is done, it safely adds its local sum to the global sum.
' After the loop is complete, the global sum is printed out.
' Documentation:
' http://msdn.microsoft.com/library/dd990270(VS.100).aspx
Private Sub ForEachDemo()
' The sum of these elements is 40.
Dim input As Integer() = {4, 1, 6, 2, 9, 5, _
10, 3}
Dim sum As Integer = 0
Try
' source collection
Parallel.ForEach(input,
Function()
' thread local initializer
Return 0
End Function,
Function(n, loopState, localSum)
' body
localSum += n
Console.WriteLine("Thread={0}, n={1}, localSum={2}", Thread.CurrentThread.ManagedThreadId, n, localSum)
Return localSum
End Function,
Sub(localSum)
' thread local aggregator
Interlocked.Add(sum, localSum)
End Sub)
Console.WriteLine(vbLf & "Sum={0}", sum)
Catch e As AggregateException
' No exception is expected in this example, but if one is still thrown from a task,
' it will be wrapped in AggregateException and propagated to the main thread.
Console.WriteLine("Parallel.ForEach has thrown an exception. THIS WAS NOT EXPECTED." & vbLf & "{0}", e)
End Try
End Sub
End Module