TPL ve geleneksel .NET zaman uyumsuz programlama

.NET, G/Ç ile ilişkili ve işlemle ilişkili zaman uyumsuz işlemleri gerçekleştirmek için aşağıdaki iki standart deseni sağlar:

• Zaman uyumsuz işlemlerin bir başlangıç/bitiş yöntemi çifti tarafından temsilildiği zaman uyumsuz Programlama Modeli (APM). Örneğin: FileStream.BeginRead ve Stream.EndRead.

• Zaman uyumsuz işlemlerin ve <OperationName>Completedadlı <OperationName>Async bir yöntem/olay çifti tarafından temsilildiği olay tabanlı zaman uyumsuz desen (EAP). Örneğin: WebClient.DownloadStringAsync ve WebClient.DownloadStringCompleted.

Görev Paralel Kitaplığı (TPL), zaman uyumsuz desenlerden biriyle birlikte çeşitli şekillerde kullanılabilir. Hem APM hem de EAP işlemlerini kitaplık tüketicilerine nesne olarak Task veya APM desenlerini kullanıma sunmanın yanı sıra bunları dahili olarak uygulamak için nesneleri kullanabilirsiniz Task . Her iki senaryoda da nesneleri kullanarak Task kodu basitleştirebilir ve aşağıdaki kullanışlı işlevlerden yararlanabilirsiniz:

• Geri çağırmaları görev başlatıldıktan sonra istediğiniz zaman görev devamlılığı biçiminde kaydedin.

• ve yöntemlerini veya WaitAll ve WaitAnyContinueWhenAny yöntemlerini kullanarak ContinueWhenAll bir Begin_ yönteme yanıt olarak yürütülen birden çok işlemi koordine edin.

• Aynı Task nesnede zaman uyumsuz G/Ç ile ilişkili ve işlem bağlı işlemleri kapsülleyin.

• Nesnenin Task durumunu izleyin.

• kullanarak TaskCompletionSource<TResult>bir işlemin durumunu bir Task nesneye hazırlama.

Görevdeki APM işlemlerini sarmalama

System.Threading.Tasks.TaskFactory Hem ve System.Threading.Tasks.TaskFactory<TResult> sınıfları, bir APM başlangıç/bitiş yöntemi çiftini TaskFactory.FromAsync bir veya Task<TResult> örnekte kapsüllemenize olanak sağlayan ve TaskFactory<TResult>.FromAsync yöntemlerinin çeşitli aşırı yüklemelerini Task sağlar. Çeşitli aşırı yüklemeler, sıfırdan üçe kadar giriş parametresi olan herhangi bir başlangıç/bitiş yöntemi çiftini barındırmaktadır.

Bir değer döndüren yöntemleri olan End çiftler için (Visual Basic'te aFunction), içindeki bir oluşturan Task<TResult>yöntemleri TaskFactory<TResult> kullanın. End void döndüren yöntemler için (Visual Basic'te aSub), içindeki bir oluşturan Taskyöntemleri TaskFactory kullanın.

Yöntemin üçten fazla parametresinin veya veya outref parametresinin Begin bulunduğu bu birkaç durumda, yalnızca End yöntemi kapsülleyen ek FromAsync aşırı yüklemeler sağlanır.

Aşağıdaki örnek, ve yöntemleriyle FromAsync eşleşen aşırı yüklemenin imzasını FileStream.BeginRead gösterir.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)

Bu aşırı yükleme aşağıdaki gibi üç giriş parametresi alır. İlk parametre, yöntemin imzası ile eşleşen bir Func<T1,T2,T3,T4,T5,TResult> temsilcidir FileStream.BeginRead . İkinci parametre, bir Func<T,TResult> alan IAsyncResult ve döndüren bir TResulttemsilcidir. Bir EndRead tamsayı döndürdüğünden, derleyici görevin türünü TResult olarak Int32 ve türünü olarak Taskçıkarsar. Son dört parametre yöntemindekilerle FileStream.BeginRead aynıdır:

• Dosya verilerinin depolandığı arabellek.

• Veri yazmaya başlamak için arabellekteki uzaklık.

• Dosyadan okunacak en fazla veri miktarı.

• Geri çağırmaya geçirebilmek için kullanıcı tanımlı durum verilerini depolayan isteğe bağlı bir nesne.

Geri çağırma işlevi için ContinueWith kullanma

Dosyadaki verilere yalnızca bayt sayısının aksine erişmeniz gerekiyorsa, FromAsync yöntem yeterli değildir. Bunun yerine, özelliği dosya verilerini içeren öğesini Result kullanınTask. Bunu, özgün göreve bir devamlılık ekleyerek yapabilirsiniz. Devamlılık, genellikle temsilci tarafından AsyncCallback gerçekleştirilecek işi gerçekleştirir. Öncül tamamlandığında ve veri arabelleği doldurulduğunda çağrılır. (Nesne FileStream geri dönmeden önce kapatılmalıdır.)

Aşağıdaki örnekte sınıfın çiftini kapsülleyen bir Task öğesininEndReadBeginRead/nasıl döndürüleceği gösterilmektedir.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

Yöntem daha sonra aşağıdaki gibi çağrılabilir.

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

Özel durum verileri sağlama

Tipik IAsyncResult işlemlerde, temsilciniz bazı özel durum verileri gerektiriyorsa, verilerin sonunda geri çağırma yöntemine geçirilen nesneye IAsyncResult paketlenebilmesi için bunu yöntemindeki son parametreden Begin geçirmeniz AsyncCallback gerekir. Bu genellikle yöntemler kullanıldığında gerekli FromAsync değildir. Özel veriler devamlılık tarafından biliniyorsa, doğrudan devamlılık temsilcisinde yakalanabilir. Aşağıdaki örnek önceki örneğe benzer, ancak süreklilik, öncül özelliğini incelemek Result yerine, devamlılık kullanıcı temsilcisi tarafından doğrudan erişilebilen özel durum verilerini inceler.

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

Birden çok FromAsync görevini eşitleme

Statik ContinueWhenAll ve ContinueWhenAny yöntemler, yöntemlerle FromAsync birlikte kullanıldığında daha fazla esneklik sağlar. Aşağıdaki örnekte birden çok zaman uyumsuz G/Ç işleminin nasıl başlatıldığı ve devamı yürütmeden önce bunların tümünün tamamlanmasını nasıl bekleyeceğiniz gösterilmektedir.

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

Yalnızca End yöntemi için FromAsync görevleri

Yöntemin Begin üçten fazla giriş parametresi gerektirdiği veya veya parametresi olan outref bu birkaç durumda, yalnızca End yöntemi temsil eden aşırı yüklemeleri TaskFactory<TResult>.FromAsync(IAsyncResult, Func<IAsyncResult,TResult>)kullanabilirsinizFromAsync. Bu yöntemler, geçirildiğiniz ve bunu bir IAsyncResult Görevde kapsüllemek istediğiniz herhangi bir senaryoda da kullanılabilir.

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

FromAsync görevlerini başlatma ve iptal etme

Bir FromAsync yöntem tarafından döndürülen görevin durumu WaitingForActivation vardır ve görev oluşturulduktan sonra bir noktada sistem tarafından başlatılır. Böyle bir görevde Başlat'ı çağırmaya çalışırsanız, bir özel durum oluşur.

Temel alınan .NET API'leri şu anda dosya veya ağ G/Ç'sinin devam eden iptalini desteklemediğinden görevi iptal FromAsync edemezsiniz. Bir çağrıyı kapsülleyen FromAsync bir yönteme iptal işlevi ekleyebilirsiniz, ancak iptali yalnızca çağrılmadan önce FromAsync veya tamamlandıktan sonra yanıtlayabilirsiniz (örneğin, bir devamlılık görevinde).

EAP'yi destekleyen bazı sınıflar, örneğin, WebClientiptali destekler ve iptal belirteçlerini kullanarak bu yerel iptal işlevini tümleştirebilirsiniz.

Karmaşık EAP işlemlerini görevler olarak kullanıma sunma

TPL, olay tabanlı zaman uyumsuz bir işlemi, yöntem ailesinin deseni sarmaladığı IAsyncResult şekilde kapsüllemek için özel olarak FromAsync tasarlanmış herhangi bir yöntem sağlamaz. Ancak, TPL herhangi bir rastgele işlem kümesini olarak Task<TResult>temsil etmek için kullanılabilecek sınıfını sağlarSystem.Threading.Tasks.TaskCompletionSource<TResult>. İşlemler zaman uyumlu veya zaman uyumsuz olabilir ve G/Ç'ye bağlı veya işlem bağlı ya da her ikisi de olabilir.

Aşağıdaki örnekte, istemci kodunda temel Task<TResult>olarak zaman uyumsuz WebClient işlemler kümesini kullanıma açmak için 'nin nasıl kullanılacağı TaskCompletionSource<TResult> gösterilmektedir. yöntemi, bir Web URL'leri dizisi ve aranacak bir terim veya ad girmenize olanak tanır ve her sitede arama teriminin kaç kez gerçekleştiğini döndürür.

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

Ek özel durum işleme içeren ve istemci kodundan yönteminin nasıl çağrılacaklarını gösteren daha eksiksiz bir örnek için bkz . Nasıl yapılır: Bir Görevde EAP Desenlerini Sarmalama.

tarafından oluşturulan herhangi bir görevin bu TaskCompletionSource görev tarafından TaskCompletionSource<TResult> başlatılacağını ve bu nedenle kullanıcı kodunun bu görevde yöntemini çağırmaması Start gerektiğini unutmayın.

Görevleri kullanarak APM desenini uygulama

Bazı senaryolarda, bir API'de begin/end yöntem çiftlerini kullanarak desenin IAsyncResult doğrudan kullanıma sunmaları istenebilir. Örneğin, mevcut API'lerle tutarlılığı korumak isteyebilir veya bu düzeni gerektiren otomatik araçlara sahip olabilirsiniz. Bu gibi durumlarda, APM deseninin dahili olarak nasıl uygulandığını basitleştirmek için nesneleri kullanabilirsiniz Task .

Aşağıdaki örnekte, uzun süre çalışan bir işlem bağlı yöntemi için APM başlangıç/bitiş yöntemi çifti uygulamak üzere görevlerin nasıl kullanılacağı gösterilmektedir.

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

StreamExtensions örnek kodunu kullanma

.NET Standart paralel uzantıları ek deposundaki StreamExtensions.cs dosyası, zaman uyumsuz dosya ve ağ G/Ç için nesneleri kullanan Task çeşitli başvuru uygulamaları içerir.

Ayrıca bkz.

• Görev Paralel Kitaplığı (TPL)