Поделиться через


Библиотека параллельных задач и традиционное асинхронное программирование .NET

Платформа .NET Framework предоставляет следующие два стандартных шаблона для выполнения асинхронных операций, связанных с вводом-выводом и ограниченных по скорости вычислений.

  • Модель асинхронного программирования (APM), в которой асинхронные операции представлены с помощью пары методов Begin и End, таких как FileStream.BeginRead и Stream.EndRead.

  • Асинхронная модель на основе событий (EAP), в которой асинхронные операции представлены с помощью пары метода и события, называемых OperationNameAsync и OperationNameCompleted, например WebClient.DownloadStringAsync и WebClient.DownloadStringCompleted. (Асинхронная модель на основе событий была введена в платформе .NET Framework версии 2.0.)

Библиотеку параллельных задач (TPL) можно использовать различными способами вместе с любой из асинхронных моделей. Можно предоставить обе операции APM и EAP как задачи для пользователей библиотеки или предоставить шаблоны APM, но использовать объекты задач для их внутренней реализации. В обоих сценариях, используя объекты задачи, можно упростить код и воспользоваться преимуществами следующих полезных функций.

  • Регистрация обратных вызовов в форме продолжений задач в любое время после запуска задачи.

  • Согласование нескольких операций, которые выполняются в ответ на метод Begin_, с использованием методов ContinueWhenAll и ContinueWhenAny либо метода WaitAll или метода WaitAny.

  • Инкапсуляция асинхронных операций, связанных с вводом-выводом и ограниченных по скорости вычислений, в одном и том же объекте задачи.

  • Отслеживание состояния объекта задачи.

  • Маршалинг состояния операции в объект задачи с помощью TaskCompletionSource<TResult>.

Заключение операций APM в задачу

Оба класса System.Threading.Tasks.TaskFactory и System.Threading.Tasks.TaskFactory<TResult> предоставляют несколько перегрузок методов FromAsync и FromAsync, позволяющих инкапсулировать пару методов Begin и End APM в один экземпляр Task или экземпляр Task<TResult>. Различные перегрузки размещают все пары методов Begin и End, имеющие от нуля до трех входных параметров.

Для пар, содержащих методы End, возвращающие значение (Function в Visual Basic), используйте методы в TaskFactory<TResult>, которая создает Task<TResult>. Для методов End, возвращающих значение void (Sub в Visual Basic), используйте методы в TaskFactory, которая создает Task.

В тех нескольких случаях, когда метод Begin имеет более трех параметров или содержит параметры ref или out, предоставляются дополнительные перегрузки FromAsync, инкапсулирующие только метод End.

В следующем примере кода показана сигнатура для перегрузки FromAsync, которая соответствует методам FileStream.BeginRead и FileStream.EndRead. Эта перегрузка принимает три входных параметра следующим образом.

Public Function FromAsync(Of TArg1, TArg2, TArg3)(
                ByVal beginMethod As Func(Of TArg1, TArg2, TArg3, AsyncCallback, Object, IAsyncResult),
                ByVal endMethod As Func(Of IAsyncResult, TResult),
                ByVal dataBuffer As TArg1,
                ByVal byteOffsetToStartAt As TArg2,
                ByVal maxBytesToRead As TArg3,
                ByVal stateInfo As Object)
public Task<TResult> FromAsync<TArg1, TArg2, TArg3>(
    Func<TArg1, TArg2, TArg3, AsyncCallback, object, IAsyncResult> beginMethod, //BeginRead
     Func<IAsyncResult, TResult> endMethod, //EndRead
     TArg1 arg1, // the byte[] buffer
     TArg2 arg2, // the offset in arg1 at which to start writing data
     TArg3 arg3, // the maximum number of bytes to read
     object state // optional state information
    ) 

Первый параметр является делегатом Func<T1, T2, T3, T4, T5, TResult>, соответствующим сигнатуре метода FileStream.BeginRead. Второй параметр является делегатом Func<T, TResult>, который принимает IAsyncResult и возвращает TResult. Поскольку метод EndRead возвращает целое число, компилятор выводит тип TResult как Int32, а тип задачи — как Task<Int32>. Последние четыре параметра идентичны параметрам метода FileStream.BeginRead.

  • Буфер для хранения данных в файле.

  • Смещение в буфере, с которого начинается запись данных.

  • Максимальный объем данных для чтения из файла.

  • Необязательный объект, который хранит определяемые пользователем данные состояния для передачи в обратный вызов.

Использование ContinueWith для функции обратного вызова

Если требуется доступ к данным файла, в отличие от числа байтов, метода FromAsync недостаточно. Вместо этого используйте Task<String>, свойство которого Result содержит данные файла. Это можно сделать, добавив продолжение в исходную задачу. Продолжение выполняет работу, которая обычно выполняется делегатом AsyncCallback. Оно вызывается по завершении предшествующей задачи, и буфер данных заполняется. (Объект FileStream необходимо закрыть перед возвратом.)

В следующем примере показано, как вернуть Task<String>, инкапсулирующий пару BeginRead и EndRead класса FileStream.

Const MAX_FILE_SIZE As Integer = 14000000
Shared Function GetFileStringAsync(ByVal path As String) As Task(Of String)
    Dim fi As New FileInfo(path)
    Dim data(fi.Length) As Byte

    Dim fs As FileStream = New FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, data.Length, True)

    ' Task(Of Integer) returns the number of bytes read
    Dim myTask As Task(Of Integer) = Task(Of Integer).Factory.FromAsync(
        AddressOf fs.BeginRead, AddressOf fs.EndRead, data, 0, data.Length, Nothing)

    ' It is possible to do other work here while waiting
    ' for the antecedent task to complete.
    ' ...

    ' Add the continuation, which returns a Task<string>. 
    Return myTask.ContinueWith(Function(antecedent)
                                   fs.Close()
                                   If (antecedent.Result < 100) Then
                                       Return "Data is too small to bother with."
                                   End If
                                   ' If we did not receive the entire file, the end of the
                                   ' data buffer will contain garbage.
                                   If (antecedent.Result < data.Length) Then
                                       Array.Resize(data, antecedent.Result)
                                   End If

                                   ' Will be returned in the Result property of the Task<string>
                                   ' at some future point after the asynchronous file I/O operation completes.
                                   Return New UTF8Encoding().GetString(data)
                               End Function)

End Function
const int MAX_FILE_SIZE = 14000000;
public static Task<string> GetFileStringAsync(string path)
{
    FileInfo fi = new FileInfo(path);
    byte[] data = null;
    data = new byte[fi.Length];

    FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, data.Length, true);

    //Task<int> returns the number of bytes read
    Task<int> task = Task<int>.Factory.FromAsync(
            fs.BeginRead, fs.EndRead, data, 0, data.Length, null);

    // It is possible to do other work here while waiting
    // for the antecedent task to complete.
    // ...

    // Add the continuation, which returns a Task<string>. 
    return task.ContinueWith((antecedent) =>
    {
        fs.Close();

        // Result = "number of bytes read" (if we need it.)
        if (antecedent.Result < 100)
        {
            return "Data is too small to bother with.";
        }
        else
        {
            // If we did not receive the entire file, the end of the
            // data buffer will contain garbage.
            if (antecedent.Result < data.Length)
                Array.Resize(ref data, antecedent.Result);

            // Will be returned in the Result property of the Task<string>
            // at some future point after the asynchronous file I/O operation completes.
            return new UTF8Encoding().GetString(data);
        }
    });
}

Затем может быть вызван метод следующим образом.

Dim myTask As Task(Of String) = GetFileStringAsync(path)

' Do some other work
' ...

Try
    Console.WriteLine(myTask.Result.Substring(0, 500))
Catch ex As AggregateException
    Console.WriteLine(ex.InnerException.Message)
End Try

Task<string> t = GetFileStringAsync(path);          

// Do some other work:
// ...

try
{
     Console.WriteLine(t.Result.Substring(0, 500));
}
catch (AggregateException ae)
{
    Console.WriteLine(ae.InnerException.Message);
}            

Предоставление пользовательских данных о состоянии

В типичных операциях IAsyncResult, если делегату AsyncCallback требуются некоторые пользовательские данные о состоянии, необходимо передать их с помощью последнего параметра в методе Begin, чтобы данные можно было упаковать в объект IAsyncResult, который в конечном счете передается методу обратного вызова. Это обычно не требуется, если используются методы FromAsync. Если пользовательские данные известны продолжению, их можно заключить непосредственно в делегат продолжения. Следующий пример напоминает предыдущий, но вместо проверки свойства Result предшествующей задачи продолжение проверяет пользовательские данные состояния, которые напрямую доступны пользовательскому делегату продолжения.

Public Function GetFileStringAsync2(ByVal path As String) As Task(Of String)
    Dim fi = New FileInfo(path)
    Dim data(fi.Length) As Byte
    Dim state As New MyCustomState()

    Dim fs As New FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, data.Length, True)
    ' We still pass null for the last parameter because
    ' the state variable is visible to the continuation delegate.
    Dim myTask As Task(Of Integer) = Task(Of Integer).Factory.FromAsync(
            AddressOf fs.BeginRead, AddressOf fs.EndRead, data, 0, data.Length, Nothing)

    Return myTask.ContinueWith(Function(antecedent)
                                   fs.Close()
                                   ' Capture custom state data directly in the user delegate.
                                   ' No need to pass it through the FromAsync method.
                                   If (state.StateData.Contains("New York, New York")) Then
                                       Return "Start spreading the news!"
                                   End If

                                   ' If we did not receive the entire file, the end of the
                                   ' data buffer will contain garbage.
                                   If (antecedent.Result < data.Length) Then
                                       Array.Resize(data, antecedent.Result)
                                   End If
                                   '/ Will be returned in the Result property of the Task<string>
                                   '/ at some future point after the asynchronous file I/O operation completes.
                                   Return New UTF8Encoding().GetString(data)
                               End Function)

End Function
public Task<string> GetFileStringAsync2(string path)
{             
    FileInfo fi = new FileInfo(path);
    byte[] data = new byte[fi.Length];                       
    MyCustomState state = GetCustomState();
    FileStream fs = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, data.Length, true);
    // We still pass null for the last parameter because
    // the state variable is visible to the continuation delegate.
    Task<int> task = Task<int>.Factory.FromAsync(
            fs.BeginRead, fs.EndRead, data, 0, data.Length, null);

    return task.ContinueWith((antecedent) =>
    {
        // It is safe to close the filestream now.
        fs.Close();

        // Capture custom state data directly in the user delegate.
        // No need to pass it through the FromAsync method.
        if (state.StateData.Contains("New York, New York"))
        {
            return "Start spreading the news!";
        }
        else
        {
            // If we did not receive the entire file, the end of the
            // data buffer will contain garbage.
            if (antecedent.Result < data.Length)
                Array.Resize(ref data, antecedent.Result);

            // Will be returned in the Result property of the Task<string>
            // at some future point after the asynchronous file I/O operation completes.
            return new UTF8Encoding().GetString(data);
        }
    });

}

Синхронизация нескольких задач FromAsync

Статические методы ContinueWhenAll и ContinueWhenAny обеспечивают дополнительную гибкость, если используются в сочетании с методами FromAsync. В следующем примере показано, как инициировать несколько асинхронных операций ввода-вывода, а затем ожидать завершения всех этих операций до выполнения продолжения.

Public Function GetMultiFileData(ByVal filesToRead As String()) As Task(Of String)
    Dim fs As FileStream
    Dim tasks(filesToRead.Length) As Task(Of String)
    Dim fileData() As Byte = Nothing
    For i As Integer = 0 To filesToRead.Length
        fileData(&H1000) = New Byte()
        fs = New FileStream(filesToRead(i), FileMode.Open, FileAccess.Read, FileShare.Read, fileData.Length, True)

        ' By adding the continuation here, the 
        ' Result of each task will be a string.
        tasks(i) = Task(Of Integer).Factory.FromAsync(AddressOf fs.BeginRead,
                                                      AddressOf fs.EndRead,
                                                      fileData,
                                                      0,
                                                      fileData.Length,
                                                      Nothing).
                                                  ContinueWith(Function(antecedent)
                                                                   fs.Close()
                                                                   'If we did not receive the entire file, the end of the
                                                                   ' data buffer will contain garbage.
                                                                   If (antecedent.Result < fileData.Length) Then
                                                                       ReDim Preserve fileData(antecedent.Result)
                                                                   End If

                                                                   'Will be returned in the Result property of the Task<string>
                                                                   ' at some future point after the asynchronous file I/O operation completes.
                                                                   Return New UTF8Encoding().GetString(fileData)
                                                               End Function)
    Next

    Return Task(Of String).Factory.ContinueWhenAll(tasks, Function(data)

                                                              ' Propagate all exceptions and mark all faulted tasks as observed.
                                                              Task.WaitAll(data)

                                                              ' Combine the results from all tasks.
                                                              Dim sb As New StringBuilder()
                                                              For Each t As Task(Of String) In data
                                                                  sb.Append(t.Result)
                                                              Next
                                                              ' Final result to be returned eventually on the calling thread.
                                                              Return sb.ToString()
                                                          End Function)
End Function
public Task<string> GetMultiFileData(string[] filesToRead)
{
    FileStream fs;
    Task<string>[] tasks = new Task<string>[filesToRead.Length];
    byte[] fileData = null;
    for (int i = 0; i < filesToRead.Length; i++)
    {
        fileData = new byte[0x1000];
        fs = new FileStream(filesToRead[i], FileMode.Open, FileAccess.Read, FileShare.Read, fileData.Length, true);

        // By adding the continuation here, the 
        // Result of each task will be a string.
        tasks[i] = Task<int>.Factory.FromAsync(
                 fs.BeginRead, fs.EndRead, fileData, 0, fileData.Length, null)
                 .ContinueWith((antecedent) =>
                     {
                         fs.Close();

                         // If we did not receive the entire file, the end of the
                         // data buffer will contain garbage.
                         if (antecedent.Result < fileData.Length)
                             Array.Resize(ref fileData, antecedent.Result);

                         // Will be returned in the Result property of the Task<string>
                         // at some future point after the asynchronous file I/O operation completes.
                         return new UTF8Encoding().GetString(fileData);
                     });
    }

    // Wait for all tasks to complete. 
    return Task<string>.Factory.ContinueWhenAll(tasks, (data) =>
    {
        // Propagate all exceptions and mark all faulted tasks as observed.
        Task.WaitAll(data);

        // Combine the results from all tasks.
        StringBuilder sb = new StringBuilder();
        foreach (var t in data)
        {
            sb.Append(t.Result);
        }
        // Final result to be returned eventually on the calling thread.
        return sb.ToString();
    });

}

Задачи FromAsync только для метода End

В тех нескольких случаях, когда метод Begin требует более трех входных параметров или содержит параметры ref либо out, можно использовать перегрузки FromAsync, например TaskFactory<TResult>.FromAsync(IAsyncResult, Func<IAsyncResult, TResult>), представляющие только метод End. Эти методы могут также использоваться в любом сценарии, в котором передается IAsyncResult и его требуется инкапсулировать в задаче.

Shared Function ReturnTaskFromAsyncResult() As Task(Of String)
    Dim ar As IAsyncResult = DoSomethingAsynchronously()
    Dim t As Task(Of String) = Task(Of String).Factory.FromAsync(ar, Function(res) CStr(res.AsyncState))
    Return t
End Function
static Task<String> ReturnTaskFromAsyncResult()
{
    IAsyncResult ar = DoSomethingAsynchronously();
    Task<String> t = Task<string>.Factory.FromAsync(ar, _ =>
        {
            return (string)ar.AsyncState;
        });

    return t;
}

Запуск и отмена задач FromAsync

Задача, возвращаемая методом FromAsync, имеет состояние WaitingForActivation и будет запущена системой в некоторой точке после создания задачи. При попытке вызвать Start для такой задачи будет создано исключение.

Задачу FromAsync невозможно отменить, поскольку базовые интерфейсы API .NET Framework в настоящее время не поддерживают отмену файла или сетевой операции ввода-вывода во время выполнения. Можно добавить функцию отмены в метод, который инкапсулирует вызов FromAsync, но ответить на отмену можно только до вызова FromAsync или после его завершения (например, в задаче продолжения).

Некоторые классы, поддерживающие EAP, например WebClient, поддерживают отмену, и можно интегрировать собственную функцию отмены с помощью токенов отмены.

Предоставление сложных операций EAP как задач

Библиотека параллельных задач не предоставляет методы, которые специально разработаны для инкапсуляции асинхронной операции на основе событий таким же образом, каким семейство методов FromAsync создает программу-оболочку для шаблона IAsyncResult. Однако она предоставляет класс System.Threading.Tasks.TaskCompletionSource<TResult>, который можно использовать для представления любого произвольного набора операций как Task<TResult>. Операции могут быть синхронными или асинхронными, связанными с вводом-выводом и ограниченными по скорости вычислений или и теми, и другими.

В следующем примере показано, как использовать TaskCompletionSource<TResult> для предоставления набора асинхронных операций WebClient клиентскому коду как базовой задачи Task. Этот метод позволяет ввести массив URL-адресов в Интернете и термин или имя для поиска, а затем возвращает количество раз, которое этот термин встречается на каждом сайте.

Class SimpleWebExample
    Dim tcs As New TaskCompletionSource(Of String())
    Dim nameToSearch As String
    Dim token As CancellationToken
    Dim results As New List(Of String)
    Dim m_lock As Object
    Dim count As Integer
    Dim addresses() As String

    Public Function GetWordCountsSimplified(ByVal urls() As String, ByVal str As String, ByVal token As CancellationToken) As Task(Of String())

        Dim webClients() As WebClient
        ReDim webClients(urls.Length)

        ' If the user cancels the CancellationToken, then we can use the
        ' WebClient's ability to cancel its own async operations.
        token.Register(Sub()
                           For Each wc As WebClient In webClients
                               If Not wc Is Nothing Then
                                   wc.CancelAsync()
                               End If
                           Next
                       End Sub)


        For i As Integer = 0 To urls.Length
            webClients(i) = New WebClient()

            ' Specify the callback for the DownloadStringCompleted
            ' event that will be raised by this WebClient instance.
            AddHandler webClients(i).DownloadStringCompleted, AddressOf WebEventHandler

            Dim address As New Uri(urls(i))
            ' Pass the address, and also use it for the userToken 
            ' to identify the page when the delegate is invoked.
            webClients(i).DownloadStringAsync(address, address)
        Next

        ' Return the underlying Task. The client code
        ' waits on the Result property, and handles exceptions
        ' in the try-catch block there.
        Return tcs.Task
    End Function

    Public Sub WebEventHandler(ByVal sender As Object, ByVal args As DownloadStringCompletedEventArgs)

        If args.Cancelled = True Then
            tcs.TrySetCanceled()
            Return
        ElseIf Not args.Error Is Nothing Then
            tcs.TrySetException(args.Error)
            Return
        Else
            ' Split the string into an array of words,
            ' then count the number of elements that match
            ' the search term.
            Dim words() As String = args.Result.Split(" "c)
            Dim NAME As String = nameToSearch.ToUpper()
            Dim nameCount = (From word In words.AsParallel()
                            Where word.ToUpper().Contains(NAME)
                            Select word).Count()

            ' Associate the results with the url, and add new string to the array that 
            ' the underlying Task object will return in its Result property.
            results.Add(String.Format("{0} has {1} instances of {2}", args.UserState, nameCount, NAME))
        End If

        SyncLock (m_lock)
            count = count + 1
            If (count = addresses.Length) Then
                tcs.TrySetResult(results.ToArray())
            End If
        End SyncLock
    End Sub
End Class
Task<string[]> GetWordCountsSimplified(string[] urls, string name, CancellationToken token)
{
    TaskCompletionSource<string[]> tcs = new TaskCompletionSource<string[]>();
    WebClient[] webClients = new WebClient[urls.Length];
    object m_lock = new object();
    int count = 0;
    List<string> results = new List<string>();

    // If the user cancels the CancellationToken, then we can use the
    // WebClient's ability to cancel its own async operations.
    token.Register(() =>
    {
        foreach (var wc in webClients)
        {
            if (wc != null)
                wc.CancelAsync();
        }
    });


    for (int i = 0; i < urls.Length; i++)
    {
        webClients[i] = new WebClient();

        #region callback
        // Specify the callback for the DownloadStringCompleted
        // event that will be raised by this WebClient instance.
        webClients[i].DownloadStringCompleted += (obj, args) =>
        {

            // Argument validation and exception handling omitted for brevity.

            // Split the string into an array of words,
            // then count the number of elements that match
            // the search term.
            string[] words = args.Result.Split(' ');
            string NAME = name.ToUpper();
            int nameCount = (from word in words.AsParallel()
                             where word.ToUpper().Contains(NAME)
                             select word)
                            .Count();

            // Associate the results with the url, and add new string to the array that 
            // the underlying Task object will return in its Result property.
            results.Add(String.Format("{0} has {1} instances of {2}", args.UserState, nameCount, name));

            // If this is the last async operation to complete,
            // then set the Result property on the underlying Task.
            lock (m_lock)
            {
                count++;
                if (count == urls.Length)
                {
                    tcs.TrySetResult(results.ToArray());
                }
            }
        };
        #endregion

        // Call DownloadStringAsync for each URL.
        Uri address = null;
        address = new Uri(urls[i]);
        webClients[i].DownloadStringAsync(address, address);

    } // end for

    // Return the underlying Task. The client code
    // waits on the Result property, and handles exceptions
    // in the try-catch block there.
    return tcs.Task;
}

Более полный пример, в котором указывается дополнительная обработка исключений и показано, как вызвать метод из клиентского кода, см. в разделе Практическое руководство. Создание задачи-оболочки для шаблонов EAP.

Помните, чтоб любая задача, созданная с помощью TaskCompletionSource<TResult>, будет запущена классом TaskCompletionSource, и, следовательно, пользовательский код не должен вызывать метод Start в этой задаче.

Реализация шаблона APM с помощью задач

В некоторых сценариях может возникнуть необходимость напрямую предоставить шаблон IAsyncResult с помощью пар методов Begin и End в API. Например, требуется поддержать совместимость с существующими интерфейсами API, или имеются автоматизированные средства, требующие этот шаблон. В таких случаях можно использовать задачи для упрощения реализации шаблона APM внутренне.

В следующем примере показано, как использовать задачи для реализации пары методов Begin и End APM для долгосрочного метода, ограниченного по скорости вычислений.

Class Calculator
    Public Function BeginCalculate(ByVal decimalPlaces As Integer, ByVal ac As AsyncCallback, ByVal state As Object) As IAsyncResult
        Console.WriteLine("Calling BeginCalculate on thread {0}", Thread.CurrentThread.ManagedThreadId)
        Dim myTask = Task(Of String).Factory.StartNew(Function(obj) Compute(decimalPlaces), state)
        myTask.ContinueWith(Sub(antedecent) ac(myTask))

    End Function
    Private Function Compute(ByVal decimalPlaces As Integer)
        Console.WriteLine("Calling compute on thread {0}", Thread.CurrentThread.ManagedThreadId)

        ' Simulating some heavy work.
        Thread.SpinWait(500000000)

        ' Actual implemenation left as exercise for the reader.
        ' Several examples are available on the Web.
        Return "3.14159265358979323846264338327950288"
    End Function

    Public Function EndCalculate(ByVal ar As IAsyncResult) As String
        Console.WriteLine("Calling EndCalculate on thread {0}", Thread.CurrentThread.ManagedThreadId)
        Return CType(ar, Task(Of String)).Result
    End Function
End Class

Class CalculatorClient
    Shared decimalPlaces As Integer
    Shared Sub Main()
        Dim calc As New Calculator
        Dim places As Integer = 35
        Dim callback As New AsyncCallback(AddressOf PrintResult)
        Dim ar As IAsyncResult = calc.BeginCalculate(places, callback, calc)

        ' Do some work on this thread while the calulator is busy.
        Console.WriteLine("Working...")
        Thread.SpinWait(500000)
        Console.ReadLine()
    End Sub

    Public Shared Sub PrintResult(ByVal result As IAsyncResult)
        Dim c As Calculator = CType(result.AsyncState, Calculator)
        Dim piString As String = c.EndCalculate(result)
        Console.WriteLine("Calling PrintResult on thread {0}; result = {1}",
                   Thread.CurrentThread.ManagedThreadId, piString)
    End Sub

End Class
class Calculator
{
    public IAsyncResult BeginCalculate(int decimalPlaces, AsyncCallback ac, object state)
    {
        Console.WriteLine("Calling BeginCalculate on thread {0}", Thread.CurrentThread.ManagedThreadId);
        Task<string> f = Task<string>.Factory.StartNew(_ => Compute(decimalPlaces), state);
        if (ac != null) f.ContinueWith((res) => ac(f));
        return f;
    }

    public string Compute(int numPlaces)
    {
        Console.WriteLine("Calling compute on thread {0}", Thread.CurrentThread.ManagedThreadId);

        // Simulating some heavy work.
        Thread.SpinWait(500000000);

        // Actual implemenation left as exercise for the reader.
        // Several examples are available on the Web.
        return "3.14159265358979323846264338327950288";
    }

    public string EndCalculate(IAsyncResult ar)
    {
        Console.WriteLine("Calling EndCalculate on thread {0}", Thread.CurrentThread.ManagedThreadId);
        return ((Task<string>)ar).Result;
    }
}

public class CalculatorClient
{
    static int decimalPlaces = 12;
    public static void Main()
    {
        Calculator calc = new Calculator();
        int places = 35;

        AsyncCallback callBack = new AsyncCallback(PrintResult);
        IAsyncResult ar = calc.BeginCalculate(places, callBack, calc);

        // Do some work on this thread while the calulator is busy.
        Console.WriteLine("Working...");
        Thread.SpinWait(500000);
        Console.ReadLine();
    }

    public static void PrintResult(IAsyncResult result)
    {
        Calculator c = (Calculator)result.AsyncState;
        string piString = c.EndCalculate(result);
        Console.WriteLine("Calling PrintResult on thread {0}; result = {1}",
                    Thread.CurrentThread.ManagedThreadId, piString);
    }
}

Использование примера кода StreamExtensions

Файл Streamextensions.cs в разделе Samples for Parallel Programming with the .NET Framework 4 на веб-сайте MSDN содержит несколько базовых реализаций, в которых используются объекты задачи для асинхронных операций с файлами и сетевых операций ввода-вывода.

См. также

Основные понятия

Библиотека параллельных задач