TPL i tradycyjne programowanie asynchroniczne platformy .NET

Artykuł
03/05/2024

Platforma .NET udostępnia następujące dwa standardowe wzorce do wykonywania operacji asynchronicznych związanych z operacjami we/wy i powiązanymi obliczeniami:

Asynchroniczny model programowania (APM), w którym operacje asynchroniczne są reprezentowane przez parę metod rozpoczęcia/zakończenia. Przykład: FileStream.BeginRead i Stream.EndRead.
Wzorzec asynchroniczny oparty na zdarzeniach (EAP), w którym operacje asynchroniczne są reprezentowane przez parę metod/zdarzeń o nazwach <OperationName>Async i <OperationName>Completed. Przykład: WebClient.DownloadStringAsync i WebClient.DownloadStringCompleted.

Biblioteka równoległa zadań (TPL) może być używana na różne sposoby w połączeniu z jednym z wzorców asynchronicznych. Operacje APM i EAP można uwidocznić zarówno jako Task obiekty dla użytkowników biblioteki, jak i uwidocznić wzorce APM, ale używać Task obiektów do ich wewnętrznego implementowania. W obu scenariuszach przy użyciu Task obiektów można uprościć kod i skorzystać z następujących przydatnych funkcji:

Zarejestruj wywołania zwrotne w postaci kontynuacji zadań w dowolnym momencie po uruchomieniu zadania.
Koordynuj wiele operacji wykonywanych w odpowiedzi na metodę przy użyciu ContinueWhenAll metod i lub WaitAll metod i ContinueWhenAny WaitAny.Begin_
Hermetyzują asynchroniczne operacje we/wy powiązane i związane z obliczeniami w tym samym Task obiekcie.
Monitoruj stan Task obiektu.
Przeprowadzanie marshalingu stanu operacji do Task obiektu przy użyciu polecenia TaskCompletionSource<TResult>.

Zawijanie operacji APM w zadaniu

System.Threading.Tasks.TaskFactory Obie klasy i System.Threading.Tasks.TaskFactory<TResult> zapewniają kilka przeciążeń TaskFactory.FromAsync metod iTaskFactory<TResult>.FromAsync, które pozwalają hermetyzować parę metod rozpoczęcia/zakończenia APM w jednym lub Task Task<TResult> wystąpieniu. Różne przeciążenia mieszczą się w dowolnej parze metody rozpoczęcia/zakończenia, które mają od zera do trzech parametrów wejściowych.

W przypadku par, które mają End metody zwracające wartość (a Function w Visual Basic), użyj metod w TaskFactory<TResult> tym pliku .Task<TResult> W przypadku End metod, które zwracają wartość void (a Sub w Visual Basic), użyj metod w TaskFactory tym pliku Task, które tworzą element .

W przypadku tych niewielu przypadków, w których Begin metoda ma więcej niż trzy parametry lub zawiera ref lub out parametry, dodatkowe FromAsync przeciążenia hermetyzujące tylko metodę End są udostępniane.

W poniższym przykładzie pokazano podpis FromAsync przeciążenia pasujący do FileStream.BeginRead metod i FileStream.EndRead .

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
    )

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)

To przeciążenie przyjmuje trzy parametry wejściowe w następujący sposób. Pierwszy parametr to Func<T1,T2,T3,T4,T5,TResult> delegat zgodny z podpisem FileStream.BeginRead metody. Drugi parametr to Func<T,TResult> delegat, który przyjmuje element IAsyncResult i zwraca wartość TResult. Ponieważ EndRead zwraca liczbę całkowitą, kompilator wywnioskuje typ TResult jako Int32 i typ zadania jako Task. Ostatnie cztery parametry są identyczne z tymi w metodzie FileStream.BeginRead :

Bufor, w którym mają być przechowywane dane pliku.
Przesunięcie w buforze, w którym należy rozpocząć zapisywanie danych.
Maksymalna ilość danych do odczytu z pliku.
Opcjonalny obiekt, który przechowuje dane stanu zdefiniowane przez użytkownika w celu przekazania do wywołania zwrotnego.

Używanie funkcji ContinueWith dla funkcji wywołania zwrotnego

Jeśli potrzebujesz dostępu do danych w pliku, a nie tylko liczby bajtów, FromAsync metoda nie jest wystarczająca. Zamiast tego należy użyć elementu Task, którego Result właściwość zawiera dane pliku. Można to zrobić, dodając kontynuację do oryginalnego zadania. Kontynuacja wykonuje pracę, która zwykle będzie wykonywana przez delegata AsyncCallback . Jest on wywoływany po zakończeniu poprzedzania, a bufor danych został wypełniony. (Obiekt FileStream powinien zostać zamknięty przed zwróceniem).

W poniższym przykładzie pokazano, jak zwrócić hermetyzację TaskEndReadBeginRead/pary FileStream klasy.

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

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

Następnie można wywołać metodę w następujący sposób.


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

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

Podaj dane stanu niestandardowego

W typowych IAsyncResult operacjach, jeśli AsyncCallback delegat wymaga pewnych danych stanu niestandardowego, musisz przekazać go za pośrednictwem ostatniego parametru w Begin metodzie, aby dane mogły zostać spakowane do IAsyncResult obiektu, który zostanie ostatecznie przekazany do metody wywołania zwrotnego. Zwykle nie jest to wymagane, gdy FromAsync są używane metody. Jeśli dane niestandardowe są znane kontynuacji, można je przechwycić bezpośrednio w delegatu kontynuacji. Poniższy przykład przypomina poprzedni przykład, ale zamiast badać Result właściwość antecedent, kontynuacja analizuje niestandardowe dane stanu, które są bezpośrednio dostępne dla delegata użytkownika kontynuacji.

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

Public Function GetFileStringAsync2(ByVal path As String) As Task(Of String)
    Dim fi = New FileInfo(path)
    Dim data(fi.Length - 1) 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

Synchronizowanie wielu zadań Zsync

Metody statyczne ContinueWhenAll i ContinueWhenAny zapewniają dodatkową elastyczność w połączeniu FromAsync z metodami. W poniższym przykładzie pokazano, jak zainicjować wiele asynchronicznych operacji we/wy, a następnie poczekać na ukończenie wszystkich operacji przed wykonaniem kontynuacji.

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();
    });
}

Public Function GetMultiFileData(ByVal filesToRead As String()) As Task(Of String)
    Dim fs As FileStream
    Dim tasks(filesToRead.Length - 1) 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

Zadania fromAsync tylko dla metody End

W przypadku tych niewielu przypadków, w których Begin metoda wymaga więcej niż trzech parametrów wejściowych lub ma ref lub out parametrów, można użyć FromAsync przeciążeń, na przykład , TaskFactory<TResult>.FromAsync(IAsyncResult, Func<IAsyncResult,TResult>)które reprezentują tylko metodę End . Te metody mogą być również używane w dowolnym scenariuszu, w którym przekazano IAsyncResult element i chcesz hermetyzować je w zadaniu.

static Task<String> ReturnTaskFromAsyncResult()
{
    IAsyncResult ar = DoSomethingAsynchronously();
    Task<String> t = Task<string>.Factory.FromAsync(ar, _ =>
        {
            return (string)ar.AsyncState;
        });

    return t;
}

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

Uruchamianie i anulowanie zadań Zsync

Zadanie zwrócone przez metodę FromAsync ma stan WaitingForActivation i zostanie uruchomione przez system w pewnym momencie po utworzeniu zadania. Jeśli spróbujesz wywołać metodę Start dla takiego zadania, zostanie zgłoszony wyjątek.

Nie można anulować FromAsync zadania, ponieważ bazowe interfejsy API platformy .NET nie obsługują obecnie anulowania operacji we/wy pliku lub sieci. Możesz dodać funkcję anulowania do metody, która hermetyzuje FromAsync wywołanie, ale możesz odpowiedzieć tylko na anulowanie przed FromAsync wywołaniem lub po zakończeniu (na przykład w zadaniu kontynuacji).

Niektóre klasy, które obsługują protokół EAP, na przykład , WebClientobsługują anulowanie i można zintegrować te natywne funkcje anulowania przy użyciu tokenów anulowania.

Uwidacznianie złożonych operacji protokołu EAP jako zadań

TPL nie udostępnia żadnych metod, które zostały specjalnie zaprojektowane do hermetyzacji operacji asynchronicznej opartej na zdarzeniach w taki sam sposób, jak FromAsync rodzina metod owijania IAsyncResult wzorca. Jednak TPL udostępnia klasę System.Threading.Tasks.TaskCompletionSource<TResult> , która może służyć do reprezentowania dowolnego zestawu operacji jako Task<TResult>. Operacje mogą być synchroniczne lub asynchroniczne i mogą być powiązane we/wy lub związane z obliczeniami albo oba te operacje.

W poniższym przykładzie pokazano, jak używać elementu TaskCompletionSource<TResult> , aby uwidocznić zestaw operacji asynchronicznych WebClient do kodu klienta jako podstawowego Task<TResult>elementu . Metoda umożliwia wprowadzenie tablicy adresów URL sieci Web oraz terminu lub nazwy do wyszukania, a następnie zwraca liczbę wystąpień terminu wyszukiwania w każdej witrynie.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Threading;
using System.Threading.Tasks;

public class SimpleWebExample
{
  public 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.
              lock (m_lock)
              {
                 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.
                 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;
   }
}

Imports System.Collections.Generic
Imports System.Net
Imports System.Threading
Imports System.Threading.Tasks

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

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

        Dim webClients(urls.Length - 1) As WebClient

        ' 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 wc IsNot Nothing Then
                                   wc.CancelAsync()
                               End If
                           Next
                       End Sub)

        For i As Integer = 0 To urls.Length - 1
            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 args.Error IsNot 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.
            SyncLock (m_lock)
                results.Add(String.Format("{0} has {1} instances of {2}", args.UserState, nameCount, nameToSearch))
                count = count + 1
                If (count = addresses.Length) Then
                    tcs.TrySetResult(results.ToArray())
                End If
            End SyncLock
        End If
    End Sub
End Class

Aby uzyskać bardziej kompletny przykład, który zawiera dodatkową obsługę wyjątków i pokazuje, jak wywołać metodę z kodu klienta, zobacz Instrukcje: zawijanie wzorców protokołu EAP w zadaniu.

Należy pamiętać, że każde zadanie utworzone przez TaskCompletionSource<TResult> element zostanie uruchomione w tym TaskCompletionSource celu i dlatego kod użytkownika nie powinien wywoływać Start metody dla tego zadania.

Implementowanie wzorca APM przy użyciu zadań

W niektórych scenariuszach może być pożądane bezpośrednie uwidocznienie IAsyncResult wzorca przy użyciu par metod begin/end w interfejsie API. Na przykład możesz zachować spójność z istniejącymi interfejsami API lub mieć zautomatyzowane narzędzia, które wymagają tego wzorca. W takich przypadkach można użyć Task obiektów, aby uprościć sposób implementacji wzorca APM wewnętrznie.

W poniższym przykładzie pokazano, jak używać zadań do implementowania pary metod rozpoczęcia/zakończenia APM dla długotrwałej metody powiązanej z obliczeniami.

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 implementation 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 calculator 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);
    }
}

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(antecedent) 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 implementation 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 calculator 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

Korzystanie z przykładowego kodu streamExtensions

Plik StreamExtensions.cs w repozytorium dodatków rozszerzeń równoległych platformy .NET Standard zawiera kilka implementacji referencyjnych, które używają Task obiektów do asynchronicznych operacji we/wy plików i sieci.

Zobacz też

Biblioteka zadań równoległych (TPL)

Udostępnij za pośrednictwem