Condividi tramite


TPL e programmazione asincrona .NET tradizionale

.NET offre i due modelli standard seguenti per l'esecuzione di operazioni asincrone associate a I/O e di calcolo:

La libreria TPL (Task Parallel Library) può essere usata in vari modi in combinazione con uno dei modelli asincroni. È possibile esporre le operazioni APM e EAP come oggetti Task ai consumer di libreria oppure esporre i modelli APM, ma usare Task oggetti per implementarli internamente. In entrambi gli scenari, usando gli oggetti Task, è possibile semplificare il codice e sfruttare le funzionalità utili seguenti:

  • Registra i callback, come continuazioni di attività, in qualsiasi momento dopo l'avvio dell'attività.

  • Coordinare più operazioni eseguite in risposta a un metodo Begin_ usando i metodi ContinueWhenAll e ContinueWhenAny oppure i metodi WaitAll e WaitAny.

  • Incapsulare le operazioni asincrone associate a I/O e associate a calcolo nello stesso oggetto Task.

  • Monitorare lo stato dell'oggetto Task.

  • Serializzare lo stato di un'operazione su un oggetto Task utilizzando TaskCompletionSource<TResult>.

Incapsulare le operazioni APM in un'attività

Sia le classi System.Threading.Tasks.TaskFactory che System.Threading.Tasks.TaskFactory<TResult> forniscono diversi overload dei metodi TaskFactory.FromAsync e TaskFactory<TResult>.FromAsync che consentono di incapsulare una coppia di metodi di inizio/fine APM in un'istanza Task o Task<TResult>. Le diverse versioni sovraccaricate supportano qualsiasi coppia di metodi begin/end che abbiano da zero a tre parametri di input.

Per le coppie con metodi End che restituiscono un valore (un Function in Visual Basic), utilizzare i metodi in TaskFactory<TResult> che creano un Task<TResult>. Per i metodi End che restituiscono void (un Sub in Visual Basic), utilizzare i metodi di TaskFactory che creano un Task.

Per questi pochi casi in cui il metodo Begin ha più di tre parametri o contiene parametri ref o out, vengono forniti overload aggiuntivi FromAsync che incapsulano solo il metodo End.

Nell'esempio seguente viene illustrata la firma per l'overload FromAsync che corrisponde ai metodi FileStream.BeginRead e 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)

Questo overload accetta tre parametri di input, come indicato di seguito. Il primo parametro è un delegato Func<T1,T2,T3,T4,T5,TResult> che corrisponde alla firma del metodo FileStream.BeginRead. Il secondo parametro è un delegato Func<T,TResult> che accetta un IAsyncResult e restituisce un TResult. Poiché EndRead restituisce un numero intero, il compilatore deduce il tipo di TResult come Int32 e il tipo dell'attività come Task. Gli ultimi quattro parametri sono identici a quelli nel metodo FileStream.BeginRead:

  • Buffer in cui archiviare i dati del file.

  • L'offset nel buffer da cui iniziare a scrivere i dati.

  • Quantità massima di dati da leggere dal file.

  • Oggetto facoltativo che archivia i dati di stato definiti dall'utente da passare al callback.

Usare ContinueWith per la funzionalità di callback

Se è necessario accedere ai dati nel file, anziché solo al numero di byte, il metodo FromAsync non è sufficiente. Usare invece Task, la cui proprietà Result contiene i dati del file. Puoi farlo aggiungendo una continuazione all'attività originale. La continuazione porta a termine il lavoro che normalmente verrebbe svolto dal delegato AsyncCallback. Viene richiamato quando l'operazione antecedente è completata e il buffer di dati è stato riempito. L'oggetto FileStream deve essere chiuso prima della restituzione.

Nell'esempio seguente viene illustrato come restituire un Task che incapsula la coppia di BeginRead/EndRead della classe FileStream.

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

Il metodo può quindi essere chiamato, come indicato di seguito.


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

Fornire dati sullo stato personalizzati

Nelle operazioni di IAsyncResult tipiche, se il delegato AsyncCallback richiede alcuni dati sullo stato personalizzati, è necessario passarli attraverso l'ultimo parametro nel metodo Begin, in modo che i dati possano essere inseriti nel pacchetto nell'oggetto IAsyncResult che viene infine passato al metodo di callback. Questo non è in genere necessario quando vengono usati i metodi di FromAsync. Se i dati personalizzati sono noti alla continuazione, è possibile acquisire i dati direttamente nel delegato di continuazione. L'esempio seguente è simile all'esempio precedente, ma invece di esaminare la proprietà Result dell'antecedent, la continuazione esamina i dati di stato personalizzati direttamente accessibili al delegato utente della continuazione.

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

Sincronizzare più attività FromAsync

I metodi ContinueWhenAll statici e ContinueWhenAny offrono maggiore flessibilità quando vengono usati insieme ai metodi FromAsync. Nell'esempio seguente viene illustrato come avviare più operazioni di I/O asincrone e quindi attendere il completamento di tutte le operazioni prima di eseguire la continuazione.

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

Attività FromAsync solo per il metodo End

Per questi pochi casi in cui il metodo Begin richiede più di tre parametri di input o ha parametri ref o out, è possibile usare gli overload FromAsync, ad esempio TaskFactory<TResult>.FromAsync(IAsyncResult, Func<IAsyncResult,TResult>), che rappresentano solo il metodo End. Questi metodi possono essere utilizzati anche in qualsiasi scenario in cui viene passato un IAsyncResult e si desidera incapsularlo in un Task.

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

Avviare e annullare attività FromAsync

L'attività restituita da un metodo FromAsync ha lo stato WaitingForActivation e verrà avviata dal sistema in un determinato momento dopo la creazione dell'attività. Se si tenta di chiamare Start per un'attività di questo tipo, verrà generata un'eccezione.

Non è possibile annullare un'attività FromAsync, perché le API .NET sottostanti attualmente non supportano l'annullamento in corso dell'I/O di file o di rete. È possibile aggiungere funzionalità di annullamento a un metodo che incapsula una chiamata FromAsync, ma è possibile rispondere all'annullamento solo prima che venga chiamato FromAsync o dopo il completamento, ad esempio in un'attività di continuazione.

Alcune classi che supportano EAP, ad esempio, WebClient, supportano l'annullamento ed è possibile integrare tale funzionalità di annullamento nativa usando i token di annullamento.

Esporre operazioni EAP complesse come attività

La libreria TPL non fornisce metodi progettati specificamente per incapsulare un'operazione asincrona basata su eventi nello stesso modo in cui la famiglia di metodi FromAsync esegue il wrapping del modello di IAsyncResult. Tuttavia, il TPL fornisce la classe System.Threading.Tasks.TaskCompletionSource<TResult>, che può essere usata per rappresentare qualsiasi set arbitrario di operazioni come Task<TResult>. Le operazioni possono essere sincrone o asincrone e possono essere associate a I/O o associate a calcolo o a entrambe.

Nell'esempio seguente viene illustrato come usare un TaskCompletionSource<TResult> per esporre un set di operazioni di WebClient asincrone al codice client come Task<TResult>di base. Il metodo consente di immettere una matrice di URL Web e un termine o un nome da cercare e quindi restituisce il numero di volte in cui si verifica il termine di ricerca in ogni sito.

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

Per un esempio più completo, che include una gestione aggiuntiva delle eccezioni e illustra come chiamare il metodo dal codice client, vedere Procedura: Incorporare i modelli EAP in un'attività.

Tenere presente che qualsiasi attività creata da un TaskCompletionSource<TResult> verrà avviata da tale TaskCompletionSource e, di conseguenza, il codice utente non deve chiamare il metodo Start per tale attività.

Implementare il modello APM usando le attività

In alcuni scenari può essere consigliabile esporre direttamente il modello di IAsyncResult usando coppie di metodi begin/end in un'API. Ad esempio, è possibile mantenere la coerenza con le API esistenti o che siano disponibili strumenti automatizzati che richiedono questo modello. In questi casi, è possibile usare Task oggetti per semplificare il modo in cui il modello APM viene implementato internamente.

Nell'esempio seguente viene illustrato come usare le attività per implementare una coppia di metodi di inizio/fine APM per un metodo associato a calcolo a esecuzione prolungata.

class Calculator
{
    public IAsyncResult BeginCalculate(int decimalPlaces, AsyncCallback ac, object state)
    {
        Console.WriteLine($"Calling BeginCalculate on thread {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 {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 {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 {Thread.CurrentThread.ManagedThreadId}; result = {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

Usare il codice di esempio StreamExtensions

Il file StreamExtensions.cs, nel repository extras delle estensioni parallele di .NET Standard, contiene diverse implementazioni di riferimento che usano oggetti Task per operazioni di I/O asincrono su file e rete.

Vedere anche