Task<TResult>.ContinueWith Metode

Referensi

Definisi

Ruang nama:: System.Threading.Tasks

Rakitan:: System.Threading.Tasks.dll

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuat tugas kelanjutan yang dijalankan saat tugas lain selesai.

Overload

ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam `continuationOptions`.
ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam `continuationOptions`.
ContinueWith(Action<Task<TResult>>, CancellationToken)	Membuat kelanjutan yang dapat dibatalkan yang dijalankan secara asinkron saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>,Object>, Object)	Membuat kelanjutan yang diteruskan informasi status dan yang dijalankan ketika target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>>)	Membuat kelanjutan yang dijalankan secara asinkron saat tugas target selesai.
ContinueWith(Action<Task<TResult>>, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam `continuationOptions`.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam `continuationOptions`.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)	Membuat kelanjutan yang dijalankan secara asinkron saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)	Membuat kelanjutan yang dijalankan secara asinkron saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron saat target Task<TResult> selesai.

ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object> continuationAction, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object, cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task

Parameter

continuationAction: Action<Task<TResult>,Object>

Tindakan yang akan dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan pemanggil sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan kelanjutan.

cancellationToken: CancellationToken

CancellationToken yang akan ditetapkan ke tugas kelanjutan baru.

continuationOptions: TaskContinuationOptions

Opsi kapan kelanjutan dijadwalkan dan bagaimana perilakunya. Ini termasuk kriteria, seperti OnlyOnCanceled, serta opsi eksekusi, seperti ExecuteSynchronously.

scheduler: TaskScheduler

TaskScheduler untuk mengaitkan dengan tugas kelanjutan dan digunakan untuk eksekusinya.

Mengembalikan

Task

Kelanjutan Taskbaru .

Pengecualian

ArgumentNullException

Argumennya scheduler adalah null.

ArgumentOutOfRangeException

Argumen continuationOptions menentukan nilai yang tidak valid untuk TaskContinuationOptions.

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

Keterangan

Yang dikembalikan Task tidak akan dijadwalkan untuk eksekusi sampai tugas saat ini selesai. Jika kriteria yang ditentukan melalui continuationOptions parameter tidak terpenuhi, tugas kelanjutan akan dibatalkan alih-alih dijadwalkan.

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object> continuationAction, object state, System.Threading.Tasks.TaskScheduler scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object, scheduler As TaskScheduler) As Task

Parameter

continuationAction: Action<Task<TResult>,Object>

Tindakan yang akan dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan pemanggil sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan kelanjutan.

scheduler: TaskScheduler

TaskScheduler untuk mengaitkan dengan tugas kelanjutan dan digunakan untuk eksekusinya.

Mengembalikan

Task

Kelanjutan Taskbaru .

Pengecualian

ArgumentNullException

Argumennya scheduler adalah null.

Keterangan

Yang dikembalikan Task tidak akan dijadwalkan untuk eksekusi sampai tugas saat ini selesai, apakah selesai karena berjalan dengan sukses, kesalahan karena pengecualian yang tidak tertangani, atau keluar lebih awal karena dibatalkan.

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object> continuationAction, object state, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object, continuationOptions As TaskContinuationOptions) As Task

Parameter

continuationAction: Action<Task<TResult>,Object>

Tindakan yang akan dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan pemanggil sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan kelanjutan.

continuationOptions: TaskContinuationOptions

Opsi kapan kelanjutan dijadwalkan dan bagaimana perilakunya. Ini termasuk kriteria, seperti OnlyOnCanceled, serta opsi eksekusi, seperti ExecuteSynchronously.

Mengembalikan

Task

Kelanjutan Taskbaru .

Pengecualian

ArgumentNullException

Argumennya continuationAction adalah null.

ArgumentOutOfRangeException

Argumen continuationOptions menentukan nilai yang tidak valid untuk TaskContinuationOptions.

Keterangan

Yang dikembalikan Task tidak akan dijadwalkan untuk eksekusi sampai tugas saat ini selesai. Jika kriteria kelanjutan yang ditentukan melalui continuationOptions parameter tidak terpenuhi, tugas kelanjutan akan dibatalkan alih-alih dijadwalkan.

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object> continuationAction, object state, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state, System.Threading.CancellationToken cancellationToken);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object, cancellationToken As CancellationToken) As Task

Parameter

continuationAction: Action<Task<TResult>,Object>

Tindakan yang akan dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan pemanggil sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan kelanjutan.

cancellationToken: CancellationToken

CancellationToken yang akan ditetapkan ke tugas kelanjutan baru.

Mengembalikan

Task

Kelanjutan Taskbaru .

Pengecualian

ArgumentNullException

Argumennya continuationAction adalah null.

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

Keterangan

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult)), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task

Parameter

continuationAction: Action<Task<TResult>>

Tindakan untuk dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions. Saat dijalankan, delegasi akan diteruskan tugas yang telah selesai sebagai argumen.

cancellationToken: CancellationToken

CancellationToken yang akan ditetapkan ke tugas kelanjutan baru.

continuationOptions: TaskContinuationOptions

Opsi kapan kelanjutan dijadwalkan dan bagaimana perilakunya. Ini termasuk kriteria, seperti OnlyOnCanceled, serta opsi eksekusi, seperti ExecuteSynchronously.

scheduler: TaskScheduler

TaskScheduler untuk mengaitkan dengan tugas kelanjutan dan digunakan untuk eksekusinya.

Mengembalikan

Task

Kelanjutan Taskbaru .

Pengecualian

ObjectDisposedException

Sudah Task<TResult> dibuang.

-atau-

Yang CancellationTokenSource dibuat cancellationToken telah dibuang.

ArgumentNullException

Argumennya continuationAction adalah null.

-atau-

Argumennya scheduler adalah null.

ArgumentOutOfRangeException

Argumen continuationOptions menentukan nilai yang tidak valid untuk TaskContinuationOptions.

Keterangan

Lihat juga

Berlaku untuk

ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult)), continuationOptions As TaskContinuationOptions) As Task

Parameter

continuationAction: Action<Task<TResult>>

Tindakan yang sesuai dengan kondisi yang ditentukan dalam continuationOptions. Saat dijalankan, delegasi akan diteruskan tugas yang telah selesai sebagai argumen.

continuationOptions: TaskContinuationOptions

Opsi kapan kelanjutan dijadwalkan dan bagaimana perilakunya. Ini termasuk kriteria, seperti OnlyOnCanceled, serta opsi eksekusi, seperti ExecuteSynchronously.

Mengembalikan

Task

Kelanjutan Taskbaru .

Pengecualian

ObjectDisposedException

Sudah Task<TResult> dibuang.

ArgumentNullException

Argumennya continuationAction adalah null.

ArgumentOutOfRangeException

Argumen continuationOptions menentukan nilai yang tidak valid untuk TaskContinuationOptions.

Keterangan

Untuk informasi selengkapnya, lihat Merangkai Tugas dengan Menggunakan Tugas Kelanjutan.

Lihat juga

Berlaku untuk

ContinueWith(Action<Task<TResult>>, CancellationToken)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dapat dibatalkan yang dijalankan secara asinkron saat target Task<TResult> selesai.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction, System.Threading.CancellationToken cancellationToken);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult)), cancellationToken As CancellationToken) As Task

Parameter

continuationAction: Action<Task<TResult>>

Tindakan yang akan dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi diteruskan tugas yang selesai sebagai argumen.

cancellationToken: CancellationToken

Token pembatalan yang diteruskan ke tugas kelanjutan baru.

Mengembalikan

Task

Tugas kelanjutan baru.

Pengecualian

ObjectDisposedException

Sudah Task<TResult> dibuang.

-atau-

Yang CancellationTokenSource dibuat cancellationToken telah dibuang.

ArgumentNullException

Argumennya continuationAction adalah null.

Contoh

Contoh berikut membuat tugas antecedent yang menggunakan Saringan Eratosthenes untuk menghitung angka utama antara 1 dan nilai yang dimasukkan oleh pengguna. Array digunakan untuk menyimpan informasi tentang bilangan prima. Indeks array mewakili angka, dan nilai elemen menunjukkan apakah angka tersebut komposit (nilainya adalah true) atau prime (nilainya adalah false). Tugas ini kemudian diteruskan ke tugas kelanjutan, yang bertanggung jawab untuk mengekstrak angka utama dari array bilangan bulat dan menampilkannya.

Token pembatalan diteruskan ke antecedent dan tugas kelanjutan. Objek System.Timers.Timer digunakan untuk menentukan nilai batas waktu 100 milidetik. Jika peristiwa diaktifkan, CancellationTokenSource.Cancel metode dipanggil, dan token pembatalan digunakan untuk meminta pembatalan tugas.

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using Timers = System.Timers;

public class Example
{
   static CancellationTokenSource ts;
   
   public static void Main(string[] args)
   {
      int upperBound = args.Length >= 1 ? Int32.Parse(args[0]) : 200;
      ts = new CancellationTokenSource();
      CancellationToken token = ts.Token;
      Timers.Timer timer = new Timers.Timer(3000);
      timer.Elapsed += TimedOutEvent;
      timer.AutoReset = false;
      timer.Enabled = true;

      var t1 = Task.Run(() => { // True = composite.
                                // False = prime.
                                bool[] values = new bool[upperBound + 1];
                                for (int ctr = 2; ctr <= (int) Math.Sqrt(upperBound); ctr++) {
                                   if (values[ctr] == false) {
                                      for (int product = ctr * ctr; product <= upperBound;
                                                                    product = product + ctr)
                                         values[product] = true;
                                   }
                                   token.ThrowIfCancellationRequested();
                                }
                                return values; }, token);

      var t2 = t1.ContinueWith( (antecedent) => { // Create a list of prime numbers.
                                                  var  primes = new List<int>();
                                                  token.ThrowIfCancellationRequested();
                                                  bool[] numbers = antecedent.Result;
                                                  string output = String.Empty;

                                                  for (int ctr = 1; ctr <= numbers.GetUpperBound(0); ctr++)
                                                     if (numbers[ctr] == false)
                                                        primes.Add(ctr);

                                                  // Create the output string.
                                                  for (int ctr = 0; ctr < primes.Count; ctr++) {
                                                     token.ThrowIfCancellationRequested();
                                                     output += primes[ctr].ToString("N0");
                                                     if (ctr < primes.Count - 1)
                                                        output += ",  ";
                                                     if ((ctr + 1) % 8 == 0)
                                                        output += Environment.NewLine;
                                                  }
                                                  //Display the result.
                                                  Console.WriteLine("Prime numbers from 1 to {0}:\n",
                                                                    upperBound);
                                                  Console.WriteLine(output);
                                                }, token);
      try {
         t2.Wait();
      }
      catch (AggregateException ae) {
         foreach (var e in ae.InnerExceptions) {
            if (e.GetType() == typeof(TaskCanceledException))
               Console.WriteLine("The operation was cancelled.");
            else
               Console.WriteLine("ELSE: {0}: {1}", e.GetType().Name, e.Message);
         }
      }
      finally {
         ts.Dispose();
      }
   }

   private static void TimedOutEvent(Object source, Timers.ElapsedEventArgs e)
   {
      ts.Cancel();
   }
}
// If cancellation is not requested, the example displays output like the following:
//       Prime numbers from 1 to 400:
//
//       1,  2,  3,  5,  7,  11,  13,  17,
//       19,  23,  29,  31,  37,  41,  43,  47,
//       53,  59,  61,  67,  71,  73,  79,  83,
//       89,  97,  101,  103,  107,  109,  113,  127,
//       131,  137,  139,  149,  151,  157,  163,  167,
//       173,  179,  181,  191,  193,  197,  199,  211,
//       223,  227,  229,  233,  239,  241,  251,  257,
//       263,  269,  271,  277,  281,  283,  293,  307,
//       311,  313,  317,  331,  337,  347,  349,  353,
//       359,  367,  373,  379,  383,  389,  397,  401
// If cancellation is requested, the example displays output like the following:
//       The operation was cancelled.

Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks
Imports Timers = System.Timers

Module Example
   Dim ts As CancellationTokenSource

   Public Sub Main(args() As String)
      Dim upperBound As Integer = If(args.Length >= 1, CInt(args(0)), 200)
      ts = New CancellationTokenSource()
      Dim token As CancellationToken = ts.Token
      Dim timer As New Timers.Timer(100)
      AddHandler timer.Elapsed, AddressOf TimedOutEvent
      timer.AutoReset = False
      timer.Enabled = True

      Dim t1 = Task.Run(Function()
                          ' True = composite.
                          ' False = prime.
                          Dim values(upperBound) As Boolean
                          For ctr = 2 To CInt(Math.Sqrt(upperBound))
                             If values(ctr) = False Then
                                For product = ctr * ctr To upperBound Step ctr
                                   values(product) = True
                                Next
                             End If
                             token.ThrowIfCancellationRequested()
                          Next
                          Return values
                       End Function, token)

      Dim t2 = t1.ContinueWith(Sub(antecedent)
                                  ' Create a list of prime numbers.
                                  Dim primes As New List(Of Integer)()
                                  token.ThrowIfCancellationRequested()
                                  Dim numbers As Boolean() = antecedent.Result
                                  Dim output As String = String.Empty
                                  
                                  For ctr As Integer = 1 To numbers.GetUpperBound(0)
                                     If numbers(ctr) = False Then primes.Add(ctr)
                                  Next

                                  ' Create the output string.
                                  For ctr As Integer = 0 To primes.Count - 1
                                     token.ThrowIfCancellationRequested()
                                     output += primes(ctr).ToString("N0")
                                     If ctr < primes.Count - 1 Then output += ",  "
                                     If (ctr + 1) Mod 8 = 0 Then output += vbCrLf
                                  Next
                                  'Display the result.
                                  Console.WriteLine("Prime numbers from 1 to {0}:{1}",
                                                    upperBound, vbCrLf)
                                  Console.WriteLine(output)
                               End Sub, token)
      Try
         t2.Wait()
      Catch ae As AggregateException
         For Each e In ae.InnerExceptions
            If e.GetType Is GetType(TaskCanceledException) Then
               Console.WriteLine("The operation was cancelled.")
            Else
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message)
            End If
         Next
      Finally
         ts.Dispose()
      End Try
   End Sub
   
   Private Sub TimedOutEvent(source As Object, e As Timers.ElapsedEventArgs)
      ts.Cancel()
   End Sub
End Module
' If cancellation is not requested, the example displays output like the following:
'       Prime numbers from 1 to 400:
'
'       1,  2,  3,  5,  7,  11,  13,  17,
'       19,  23,  29,  31,  37,  41,  43,  47,
'       53,  59,  61,  67,  71,  73,  79,  83,
'       89,  97,  101,  103,  107,  109,  113,  127,
'       131,  137,  139,  149,  151,  157,  163,  167,
'       173,  179,  181,  191,  193,  197,  199,  211,
'       223,  227,  229,  233,  239,  241,  251,  257,
'       263,  269,  271,  277,  281,  283,  293,  307,
'       311,  313,  317,  331,  337,  347,  349,  353,
'       359,  367,  373,  379,  383,  389,  397,  401
' If cancellation is requested, the example displays output like the following:
'       The operation was cancelled.

Biasanya, memasok nilai sekitar 100.000 menyebabkan interval batas waktu kedaluwarsa dan Timer.Elapsed peristiwa diaktifkan, dan permintaan pembatalan ditetapkan.

Keterangan

Lihat juga

Berlaku untuk

ContinueWith(Action<Task<TResult>,Object>, Object)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang diteruskan informasi status dan yang dijalankan ketika target Task<TResult> selesai.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object> continuationAction, object state);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object) As Task

Parameter

continuationAction: Action<Task<TResult>,Object>

Tindakan yang akan dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi melewati tugas yang selesai dan objek status yang disediakan penelepon sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh tindakan kelanjutan.

Mengembalikan

Task

Kelanjutan Taskbaru .

Pengecualian

ArgumentNullException

Argumennya continuationAction adalah null.

Contoh

Contoh berikut membuat tugas yang diteruskan bilangan bulat antara 2 dan 20 dan mengembalikan array yang berisi sepuluh eksponen pertama (dari n¹ hingga n¹⁰) dari angka tersebut. Tugas kelanjutan kemudian bertanggung jawab untuk menampilkan eksponen. Ini diteruskan baik antecedent dan angka asli yang eksponennya dihasilkan oleh anseten.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var cts = new CancellationTokenSource();
      var token = cts.Token;

      // Get an integer to generate a list of its exponents.
      var rnd = new Random();
      var number = rnd.Next(2, 21);
      
      var t = Task.Factory.StartNew( (value) => { int n = (int) value;
                                                  long[] values = new long[10];
                                                  for (int ctr = 1; ctr <= 10; ctr++)
                                                     values[ctr - 1] = (long) Math.Pow(n, ctr);
                                                     
                                                  return values;
                                                }, number);
      var continuation = t.ContinueWith( (antecedent, value) => { Console.WriteLine("Exponents of {0}:", value);
                                                                  for (int ctr = 0; ctr <= 9; ctr++)
                                                                     Console.WriteLine("   {0} {1} {2} = {3:N0}",
                                                                                       value, "\u02C6", ctr + 1,
                                                                                       antecedent.Result[ctr]);
                                                                  Console.WriteLine();
                                                                }, number);
      continuation.Wait();
      cts.Dispose();
   }
}
// The example displays output like the following:
//       Exponents of 2:
//          2 ^ 1 = 2
//          2 ^ 2 = 4
//          2 ^ 3 = 8
//          2 ^ 4 = 16
//          2 ^ 5 = 32
//          2 ^ 6 = 64
//          2 ^ 7 = 128
//          2 ^ 8 = 256
//          2 ^ 9 = 512
//          2 ^ 10 = 1,024

Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim cts As New CancellationTokenSource()
      Dim token As CancellationToken = cts.Token

      ' Get an integer to generate a list of its exponents.
      Dim rnd As New Random()
      Dim number As Integer = rnd.Next(2, 21)

      Dim t = Task.Factory.StartNew( Function(value)
                                        Dim n As Integer = CInt(value)
                                        Dim values(9) As Long
                                        For ctr As Integer = 1 To 10
                                           values(ctr - 1) = CLng(Math.Pow(n, ctr))
                                        Next
                                        return values
                                     End Function, number)
      Dim continuation = t.ContinueWith( Sub(antecedent, value)
                                            Console.WriteLine("Exponents of {0}:", value)
                                            For ctr As Integer = 0 To 9
                                               Console.WriteLine("   {0} {1} {2} = {3:N0}",
                                                                 value, ChrW(&h02C6), ctr + 1,
                                                                 antecedent.Result(ctr))
                                            Next
                                            Console.WriteLine()
                                         End Sub, number)
      continuation.Wait()

      cts.Dispose()
   End Sub
End Module
' The example displays output like the following:
'       Exponents of 2:
'          2 ^ 1 = 2
'          2 ^ 2 = 4
'          2 ^ 3 = 8
'          2 ^ 4 = 16
'          2 ^ 5 = 32
'          2 ^ 6 = 64
'          2 ^ 7 = 128
'          2 ^ 8 = 256
'          2 ^ 9 = 512
'          2 ^ 10 = 1,024

Keterangan

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith(Action<Task<TResult>>)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan secara asinkron saat tugas target selesai.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult))) As Task

Parameter

continuationAction: Action<Task<TResult>>

Tindakan yang dijalankan saat antecedent Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang telah selesai sebagai argumen.

Mengembalikan

Task

Tugas kelanjutan baru.

Pengecualian

ObjectDisposedException

Sudah Task<TResult> dibuang.

ArgumentNullException

Argumennya continuationAction adalah null.

Contoh

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

public class Example
{
   public static void Main(string[] args)
   {
      int upperBound = args.Length >= 1 ? Int32.Parse(args[0]) : 200;

      var t1 = Task.Run(() => { // True = composite.
                                // False = prime.
                                bool[] values = new bool[upperBound + 1];
                                for (int ctr = 2; ctr <= (int) Math.Sqrt(upperBound); ctr++) {
                                   if (values[ctr] == false) {
                                      for (int product = ctr * ctr; product <= upperBound;
                                                                    product = product + ctr)
                                         values[product] = true;
                                   }
                                }
                                return values; });
      var t2 = t1.ContinueWith( (antecedent) => { // Create a list of prime numbers.
                                                  var  primes = new List<int>();
                                                  bool[] numbers = antecedent.Result;
                                                  string output = String.Empty;

                                                  for (int ctr = 1; ctr <= numbers.GetUpperBound(0); ctr++)
                                                     if (numbers[ctr] == false)
                                                        primes.Add(ctr);

                                                  // Create the output string.
                                                  for (int ctr = 0; ctr < primes.Count; ctr++) {
                                                     output += primes[ctr].ToString("N0");
                                                     if (ctr < primes.Count - 1)
                                                        output += ",  ";
                                                     if ((ctr + 1) % 8 == 0)
                                                        output += Environment.NewLine;
                                                  }
                                                  //Display the result.
                                                  Console.WriteLine("Prime numbers from 1 to {0}:\n",
                                                                    upperBound);
                                                  Console.WriteLine(output);
                                                });
      try {
         t2.Wait();
      }
      catch (AggregateException ae) {
         foreach (var e in ae.InnerExceptions)
            Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message);
      }
   }
}
// The example displays output like the following:
//       Prime numbers from 1 to 400:
//
//       1,  2,  3,  5,  7,  11,  13,  17,
//       19,  23,  29,  31,  37,  41,  43,  47,
//       53,  59,  61,  67,  71,  73,  79,  83,
//       89,  97,  101,  103,  107,  109,  113,  127,
//       131,  137,  139,  149,  151,  157,  163,  167,
//       173,  179,  181,  191,  193,  197,  199,  211,
//       223,  227,  229,  233,  239,  241,  251,  257,
//       263,  269,  271,  277,  281,  283,  293,  307,
//       311,  313,  317,  331,  337,  347,  349,  353,
//       359,  367,  373,  379,  383,  389,  397,  401

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

Module Example
   Public Sub Main(args() As String)
      Dim upperBound As Integer = If(args.Length >= 1, CInt(args(0)), 200)

      Dim t1 = Task.Run(Function()
                          ' True = composite.
                          ' False = prime.
                          Dim values(upperBound) As Boolean
                          For ctr = 2 To CInt(Math.Sqrt(upperBound))
                             If values(ctr) = False Then
                                For product = ctr * ctr To upperBound Step ctr
                                   values(product) = True
                                Next
                             End If
                          Next
                          Return values
                       End Function)

      Dim t2 = t1.ContinueWith(Sub(antecedent)
                                  ' Create a list of prime numbers.
                                  Dim primes As New List(Of Integer)()
                                  Dim numbers As Boolean() = antecedent.Result
                                  Dim output As String = String.Empty
                                  
                                  For ctr As Integer = 1 To numbers.GetUpperBound(0)
                                     If numbers(ctr) = False Then primes.Add(ctr)
                                  Next

                                  ' Create the output string.
                                  For ctr As Integer = 0 To primes.Count - 1
                                     output += primes(ctr).ToString("N0")
                                     If ctr < primes.Count - 1 Then output += ",  "
                                     If (ctr + 1) Mod 8 = 0 Then output += vbCrLf
                                  Next
                                  'Display the result.
                                  Console.WriteLine("Prime numbers from 1 to {0}:{1}",
                                                    upperBound, vbCrLf)
                                  Console.WriteLine(output)
                               End Sub)
      Try
         t2.Wait()
      Catch ae As AggregateException
         For Each e In ae.InnerExceptions
            Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message)
         Next
      End Try
   End Sub
End Module
' The example displays output like the following:
'       Prime numbers from 1 to 400:
'
'       1,  2,  3,  5,  7,  11,  13,  17,
'       19,  23,  29,  31,  37,  41,  43,  47,
'       53,  59,  61,  67,  71,  73,  79,  83,
'       89,  97,  101,  103,  107,  109,  113,  127,
'       131,  137,  139,  149,  151,  157,  163,  167,
'       173,  179,  181,  191,  193,  197,  199,  211,
'       223,  227,  229,  233,  239,  241,  251,  257,
'       263,  269,  271,  277,  281,  283,  293,  307,
'       311,  313,  317,  331,  337,  347,  349,  353,
'       359,  367,  373,  379,  383,  389,  397,  401
' If cancellation is requested, the example displays output like the following:
'       The operation was cancelled.

Keterangan

Lihat juga

Berlaku untuk

ContinueWith(Action<Task<TResult>>, TaskScheduler)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan secara asinkron saat target Task<TResult> selesai.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult)), scheduler As TaskScheduler) As Task

Parameter

continuationAction: Action<Task<TResult>>

Tindakan yang akan dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang telah selesai sebagai argumen.

scheduler: TaskScheduler

TaskScheduler untuk mengaitkan dengan tugas kelanjutan dan digunakan untuk eksekusinya.

Mengembalikan

Task

Kelanjutan Taskbaru .

Pengecualian

ObjectDisposedException

Sudah Task<TResult> dibuang.

ArgumentNullException

Argumennya continuationAction adalah null.

-atau-

Argumennya scheduler adalah null.

Keterangan

Lihat juga

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object,TNewResult> continuationFunction, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object, cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,Object,TNewResult>

Fungsi yang akan dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan pemanggil sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh fungsi kelanjutan.

cancellationToken: CancellationToken

CancellationToken yang akan ditetapkan ke tugas baru.

continuationOptions: TaskContinuationOptions

Opsi kapan kelanjutan dijadwalkan dan bagaimana perilakunya. Ini termasuk kriteria, seperti OnlyOnCanceled, serta opsi eksekusi, seperti ExecuteSynchronously.

scheduler: TaskScheduler

TaskScheduler untuk mengaitkan dengan tugas kelanjutan dan digunakan untuk eksekusinya.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ArgumentNullException

Argumennya scheduler adalah null.

ArgumentOutOfRangeException

Argumen continuationOptions menentukan nilai yang tidak valid untuk TaskContinuationOptions.

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

Keterangan

Yang dikembalikan Task<TResult> tidak akan dijadwalkan untuk eksekusi sampai tugas saat ini selesai, apakah selesai karena berjalan dengan sukses, kesalahan karena pengecualian yang tidak tertangani, atau keluar lebih awal karena dibatalkan.

continuationFunction, ketika dijalankan, harus mengembalikan Task<TResult>. Status penyelesaian tugas ini akan ditransfer ke tugas yang dikembalikan dari Task<TResult>.ContinueWith panggilan.

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,TNewResult>

Fungsi yang akan dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.

Saat dijalankan, delegasi akan diteruskan sebagai argumen tugas yang diselesaikan ini.

cancellationToken: CancellationToken

CancellationToken yang akan ditetapkan ke tugas baru.

continuationOptions: TaskContinuationOptions

Opsi kapan kelanjutan dijadwalkan dan bagaimana perilakunya. Ini termasuk kriteria, seperti OnlyOnCanceled, serta opsi eksekusi, seperti ExecuteSynchronously.

scheduler: TaskScheduler

TaskScheduler untuk mengaitkan dengan tugas kelanjutan dan digunakan untuk eksekusinya.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ObjectDisposedException

Task<TResult> Telah dibuang.

-atau-

CancellationTokenSource Yang dibuat cancellationToken telah dibuang.

ArgumentNullException

Argumennya continuationFunction adalah null.

-atau-

Argumennya scheduler adalah null.

ArgumentOutOfRangeException

Argumen continuationOptions menentukan nilai yang tidak valid untuk TaskContinuationOptions.

Keterangan

Yang dikembalikan Task<TResult> tidak akan dijadwalkan untuk eksekusi sampai tugas saat ini selesai, apakah selesai karena berhasil berjalan hingga selesai, kesalahan karena pengecualian yang tidak tertangani, atau keluar lebih awal karena dibatalkan.

continuationFunction, ketika dijalankan, harus mengembalikan Task<TResult>.

Lihat juga

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object,TNewResult> continuationFunction, object state, System.Threading.Tasks.TaskScheduler scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object, scheduler As TaskScheduler) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,Object,TNewResult>

Fungsi yang dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan penelepon sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh fungsi kelanjutan.

scheduler: TaskScheduler

TaskScheduler untuk mengaitkan dengan tugas kelanjutan dan digunakan untuk eksekusinya.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ArgumentNullException

Argumennya scheduler adalah null.

Keterangan

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object,TNewResult> continuationFunction, object state, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state, System.Threading.CancellationToken cancellationToken);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object, cancellationToken As CancellationToken) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,Object,TNewResult>

Fungsi yang dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan penelepon sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh fungsi kelanjutan.

cancellationToken: CancellationToken

CancellationToken yang akan ditetapkan ke tugas baru.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ArgumentNullException

Argumennya continuationFunction adalah null.

ObjectDisposedException

Yang disediakan CancellationToken telah dibuang.

Keterangan

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object,TNewResult> continuationFunction, object state, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object, continuationOptions As TaskContinuationOptions) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,Object,TNewResult>

Fungsi yang dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan penelepon sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh fungsi kelanjutan.

continuationOptions: TaskContinuationOptions

Opsi kapan kelanjutan dijadwalkan dan bagaimana perilakunya. Ini termasuk kriteria, seperti OnlyOnCanceled, serta opsi eksekusi, seperti ExecuteSynchronously.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ArgumentNullException

Argumennya continuationFunction adalah null.

ArgumentOutOfRangeException

Argumen continuationOptions menentukan nilai yang tidak valid untuk TaskContinuationOptions.

Keterangan

continuationFunction, ketika dijalankan, harus mengembalikan Task<TResult>. Status penyelesaian tugas ini akan ditransfer ke tugas yang dikembalikan dari panggilan ContinueWith.

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult), continuationOptions As TaskContinuationOptions) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,TNewResult>

Fungsi yang akan dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.

Saat dijalankan, delegasi akan diteruskan tugas yang selesai sebagai argumen.

continuationOptions: TaskContinuationOptions

Opsi kapan kelanjutan dijadwalkan dan bagaimana perilakunya. Ini termasuk kriteria, seperti OnlyOnCanceled, serta opsi eksekusi, seperti ExecuteSynchronously.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ObjectDisposedException

Task<TResult> Telah dibuang.

ArgumentNullException

Argumennya continuationFunction adalah null.

ArgumentOutOfRangeException

Argumen continuationOptions menentukan nilai yang tidak valid untuk TaskContinuationOptions.

Keterangan

continuationFunction, ketika dijalankan, harus mengembalikan Task<TResult>.

Lihat juga

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan secara asinkron saat target Task<TResult> selesai.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction, System.Threading.CancellationToken cancellationToken);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult), cancellationToken As CancellationToken) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,TNewResult>

Fungsi yang dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai sebagai argumen.

cancellationToken: CancellationToken

CancellationToken yang akan ditetapkan ke tugas baru.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ObjectDisposedException

Task<TResult> Telah dibuang.

-atau-

CancellationTokenSource Yang dibuat cancellationToken telah dibuang.

ArgumentNullException

Argumennya continuationFunction adalah null.

Keterangan

Lihat juga

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object,TNewResult> continuationFunction, object state);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,Object,TNewResult>

Fungsi yang dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai dan objek status yang disediakan penelepon sebagai argumen.

state: Object

Objek yang mewakili data yang akan digunakan oleh fungsi kelanjutan.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ArgumentNullException

Argumennya continuationFunction adalah null.

Contoh

Contoh berikut membuat rantai tugas kelanjutan. Setiap tugas menyediakan waktu saat ini, DateTime objek , untuk argumen ContinueWith(Action<Task,Object>, Object) status metode . Setiap DateTime nilai mewakili waktu saat tugas lanjutan dibuat. Setiap tugas menghasilkan sebagai hasilnya nilai kedua DateTime yang mewakili waktu di mana tugas selesai. Setelah semua tugas selesai, contoh menampilkan tanggal dan waktu di mana setiap tugas kelanjutan dimulai dan selesai.

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

// Demonstrates how to associate state with task continuations.
class ContinuationState
{
   // Simluates a lengthy operation and returns the time at which
   // the operation completed.
   public static DateTime DoWork()
   {
      // Simulate work by suspending the current thread
      // for two seconds.
      Thread.Sleep(2000);

      // Return the current time.
      return DateTime.Now;
   }

   static void Main(string[] args)
   {
      // Start a root task that performs work.
      Task<DateTime> t = Task<DateTime>.Run(delegate { return DoWork(); });

      // Create a chain of continuation tasks, where each task is
      // followed by another task that performs work.
      List<Task<DateTime>> continuations = new List<Task<DateTime>>();
      for (int i = 0; i < 5; i++)
      {
         // Provide the current time as the state of the continuation.
         t = t.ContinueWith(delegate { return DoWork(); }, DateTime.Now);
         continuations.Add(t);
      }

      // Wait for the last task in the chain to complete.
      t.Wait();

      // Print the creation time of each continuation (the state object)
      // and the completion time (the result of that task) to the console.
      foreach (var continuation in continuations)
      {
         DateTime start = (DateTime)continuation.AsyncState;
         DateTime end = continuation.Result;

         Console.WriteLine("Task was created at {0} and finished at {1}.",
            start.TimeOfDay, end.TimeOfDay);
      }
   }
}

/* Sample output:
Task was created at 10:56:21.1561762 and finished at 10:56:25.1672062.
Task was created at 10:56:21.1610677 and finished at 10:56:27.1707646.
Task was created at 10:56:21.1610677 and finished at 10:56:29.1743230.
Task was created at 10:56:21.1610677 and finished at 10:56:31.1779883.
Task was created at 10:56:21.1610677 and finished at 10:56:33.1837083.
*/

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

' Demonstrates how to associate state with task continuations.
Public Module ContinuationState
   ' Simluates a lengthy operation and returns the time at which
   ' the operation completed.
   Public Function DoWork() As Date
      ' Simulate work by suspending the current thread 
      ' for two seconds.
      Thread.Sleep(2000)

      ' Return the current time.
      Return Date.Now
   End Function

   Public Sub Main()
      ' Start a root task that performs work.
      Dim t As Task(Of Date) = Task(Of Date).Run(Function() DoWork())

      ' Create a chain of continuation tasks, where each task is
      ' followed by another task that performs work.
      Dim continuations As New List(Of Task(Of DateTime))()
      For i As Integer = 0 To 4
         ' Provide the current time as the state of the continuation.
         t = t.ContinueWith(Function(antecedent, state) DoWork(), DateTime.Now)
         continuations.Add(t)
      Next

      ' Wait for the last task in the chain to complete.
      t.Wait()

      ' Display the creation time of each continuation (the state object)
      ' and the completion time (the result of that task) to the console.
      For Each continuation In continuations
         Dim start As DateTime = CDate(continuation.AsyncState)
         Dim [end] As DateTime = continuation.Result

         Console.WriteLine("Task was created at {0} and finished at {1}.",
            start.TimeOfDay, [end].TimeOfDay)
      Next
   End Sub
End Module
' The example displays output like the following:
'       Task was created at 10:56:21.1561762 and finished at 10:56:25.1672062.
'       Task was created at 10:56:21.1610677 and finished at 10:56:27.1707646.
'       Task was created at 10:56:21.1610677 and finished at 10:56:29.1743230.
'       Task was created at 10:56:21.1610677 and finished at 10:56:31.1779883.
'       Task was created at 10:56:21.1610677 and finished at 10:56:33.1837083.

Keterangan

Lihat juga

Merangkai Tugas dengan Menggunakan Tugas Kelanjutan

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan secara asinkron saat target Task<TResult> selesai.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult)) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,TNewResult>

Fungsi yang dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai sebagai argumen.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ObjectDisposedException

Task<TResult> Telah dibuang.

ArgumentNullException

Argumennya continuationFunction adalah null.

Keterangan

Lihat juga

Berlaku untuk

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)

Sumber:: Future.cs

Sumber:: Future.cs

Sumber:: Future.cs

Membuat kelanjutan yang dijalankan secara asinkron saat target Task<TResult> selesai.

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult), scheduler As TaskScheduler) As Task(Of TNewResult)

Jenis parameter

TNewResult

Jenis hasil yang dihasilkan oleh kelanjutan.

Parameter

continuationFunction: Func<Task<TResult>,TNewResult>

Fungsi yang dijalankan saat Task<TResult> selesai. Saat dijalankan, delegasi akan diteruskan tugas yang selesai sebagai argumen.

scheduler: TaskScheduler

TaskScheduler untuk mengaitkan dengan tugas kelanjutan dan digunakan untuk eksekusinya.

Mengembalikan

Task<TNewResult>

Kelanjutan Task<TResult>baru .

Pengecualian

ObjectDisposedException

Task<TResult> Telah dibuang.

ArgumentNullException

Argumennya continuationFunction adalah null.

-atau-

Argumennya scheduler adalah null.

Keterangan

Lihat juga

Berlaku untuk