Task<TResult>.ContinueWith Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Başka bir görev tamamlandığında yürütülen bir devamlılık görevi oluşturur.
Aşırı Yüklemeler
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
Devamlılık eylemi tarafından kullanılacak verileri temsil eden bir nesne.
- cancellationToken
- CancellationToken
Yeni CancellationToken devamlılık görevine atanacak olan.
- continuationOptions
- TaskContinuationOptions
Devamlılık zamanlandığında ve nasıl davranacağını gösteren seçenekler. Buna gibi OnlyOnCanceledölçütlerin yanı sıra gibi yürütme seçenekleri ExecuteSynchronouslyde dahildir.
- scheduler
- TaskScheduler
TaskScheduler devamlılık göreviyle ilişkilendirilecek ve yürütülmesi için kullanılacak.
Döndürülenler
Yeni bir devamlılık Task.
Özel durumlar
bağımsız scheduler
değişkenidir null
.
continuationOptions
bağımsız değişkeni için TaskContinuationOptionsgeçersiz bir değer belirtir.
Sağlananlar CancellationToken zaten atılmış.
Açıklamalar
Döndürülen Task görev, geçerli görev tamamlanana kadar yürütülecek şekilde zamanlanmaz. Parametresi aracılığıyla continuationOptions
belirtilen ölçütler karşılanmazsa, devamlılık görevi zamanlanmış yerine iptal edilir.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
Devamlılık eylemi tarafından kullanılacak verileri temsil eden bir nesne.
- scheduler
- TaskScheduler
TaskScheduler devamlılık göreviyle ilişkilendirilecek ve yürütülmesi için kullanılacak.
Döndürülenler
Yeni bir devamlılık Task.
Özel durumlar
bağımsız scheduler
değişkenidir null
.
Açıklamalar
Döndürülen Task , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
Devamlılık eylemi tarafından kullanılacak verileri temsil eden bir nesne.
- continuationOptions
- TaskContinuationOptions
Devamlılık zamanlandığında ve nasıl davranacağını gösteren seçenekler. Buna gibi OnlyOnCanceledölçütlerin yanı sıra gibi yürütme seçenekleri ExecuteSynchronouslyde dahildir.
Döndürülenler
Yeni bir devamlılık Task.
Özel durumlar
bağımsız continuationAction
değişkenidir null
.
continuationOptions
bağımsız değişkeni için TaskContinuationOptionsgeçersiz bir değer belirtir.
Açıklamalar
Döndürülen Task görev, geçerli görev tamamlanana kadar yürütülecek şekilde zamanlanmaz. parametresi aracılığıyla continuationOptions
belirtilen devamlılık ölçütleri karşılanmazsa, devamlılık görevi zamanlanmış yerine iptal edilir.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
Devamlılık eylemi tarafından kullanılacak verileri temsil eden bir nesne.
- cancellationToken
- CancellationToken
Yeni CancellationToken devamlılık görevine atanacak olan.
Döndürülenler
Yeni bir devamlılık Task.
Özel durumlar
bağımsız continuationAction
değişkenidir null
.
Sağlananlar CancellationToken zaten atılmış.
Açıklamalar
Döndürülen Task , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
içinde continuationOptions
belirtilen koşula göre yürütülen bir devamlılık oluşturur.
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
Parametreler
içinde continuationOptions
belirtilen koşula göre çalıştırılacak bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
- cancellationToken
- CancellationToken
Yeni CancellationToken devamlılık görevine atanacak olan.
- continuationOptions
- TaskContinuationOptions
Devamlılık zamanlandığında ve nasıl davranacağını gösteren seçenekler. Buna gibi OnlyOnCanceledölçütlerin yanı sıra gibi yürütme seçenekleri ExecuteSynchronouslyde dahildir.
- scheduler
- TaskScheduler
TaskScheduler devamlılık göreviyle ilişkilendirilecek ve yürütülmesi için kullanılacak.
Döndürülenler
Yeni bir devamlılık Task.
Özel durumlar
Task<TResult> yok edildi.
-veya-
Oluşturulan CancellationTokenSourcecancellationToken
zaten atılmış.
bağımsız continuationAction
değişkenidir null
.
-veya-
bağımsız scheduler
değişkenidir null
.
continuationOptions
bağımsız değişkeni için TaskContinuationOptionsgeçersiz bir değer belirtir.
Açıklamalar
Döndürülen Task görev, geçerli görev tamamlanana kadar yürütülecek şekilde zamanlanmaz. Parametresi aracılığıyla continuationOptions
belirtilen ölçütler karşılanmazsa, devamlılık görevi zamanlanmış yerine iptal edilir. Daha fazla bilgi için bkz. Devamlılık Görevlerini Kullanarak Görevleri Zincirleme.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
içinde continuationOptions
belirtilen koşula göre yürütülen bir devamlılık oluşturur.
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
Parametreler
içinde continuationOptions
belirtilen koşula göre öğesine yönelik bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
- continuationOptions
- TaskContinuationOptions
Devamlılık zamanlandığında ve nasıl davranacağını gösteren seçenekler. Buna gibi OnlyOnCanceledölçütlerin yanı sıra gibi yürütme seçenekleri ExecuteSynchronouslyde dahildir.
Döndürülenler
Yeni bir devamlılık Task.
Özel durumlar
Task<TResult> yok edildi.
bağımsız continuationAction
değişkenidir null
.
continuationOptions
bağımsız değişkeni için TaskContinuationOptionsgeçersiz bir değer belirtir.
Açıklamalar
Döndürülen Task görev, geçerli görev tamamlanana kadar yürütülecek şekilde zamanlanmaz. parametresi aracılığıyla continuationOptions
belirtilen devamlılık ölçütleri karşılanmazsa, devamlılık görevi zamanlanmış yerine iptal edilir.
Daha fazla bilgi için bkz. Devamlılık Görevlerini Kullanarak Görevleri Zincirleme.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith(Action<Task<TResult>>, CancellationToken)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen iptal edilebilir bir devamlılık oluşturur.
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
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
- cancellationToken
- CancellationToken
Yeni devamlılık görevine geçirilen iptal belirteci.
Döndürülenler
Yeni bir devamlılık görevi.
Özel durumlar
bağımsız continuationAction
değişkenidir null
.
Örnekler
Aşağıdaki örnek, 1 ile kullanıcı tarafından girilen değer arasındaki asal sayıları hesaplamak için Eratosthenes'in Sieve'ini kullanan bir öncül görev oluşturur. Bir dizi, asal sayılar hakkındaki bilgileri tutmak için kullanılır. Dizi dizini sayıyı temsil eder ve öğenin değeri, sayın bileşik mi (değeri true
) yoksa asal mı (değeridir false
) olduğunu gösterir. Bu görev daha sonra tamsayı dizisinden asal sayıları ayıklamaktan ve bunları görüntülemekten sorumlu olan bir devamlılık görevine geçirilir.
Hem öncül hem de devam görevine bir iptal belirteci geçirilir. System.Timers.Timer Nesne, 100 milisaniyelik bir zaman aşımı değeri tanımlamak için kullanılır. Olay tetikleniyorsa CancellationTokenSource.Cancel yöntemi çağrılır ve iptal belirteci görevlerin iptalini istemek için kullanılır.
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.
Genellikle, yaklaşık 100.000 değeri sağlamak zaman aşımı aralığının süresinin dolmasına ve Timer.Elapsed olayın tetiklenmesine ve iptal isteğinin ayarlanmasına neden olur.
Açıklamalar
Döndürülen Task , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith(Action<Task<TResult>,Object>, Object)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Durum bilgileri geçirilen ve hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
Devamlılık eylemi tarafından kullanılacak verileri temsil eden bir nesne.
Döndürülenler
Yeni bir devamlılık Task.
Özel durumlar
bağımsız continuationAction
değişkenidir null
.
Örnekler
Aşağıdaki örnek, 2 ile 20 arasında bir tamsayı geçirilen bir görev oluşturur ve bu sayının ilk on üssünü (n1 ile n10 arasında) içeren bir dizi döndürür. Daha sonra bir devamlılık görevi üsleri görüntülemekle sorumludur. Hem öncül hem de üsleri öncül tarafından oluşturulan özgün sayı geçirilir.
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
Açıklamalar
Döndürülen Task , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith(Action<Task<TResult>>)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef görev tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
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
Parametreler
Öncül tamamlandığında çalıştırılacak eylem Task<TResult> . Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
Döndürülenler
Yeni bir devamlılık görevi.
Özel durumlar
Task<TResult> yok edildi.
bağımsız continuationAction
değişkenidir null
.
Örnekler
Aşağıdaki örnek, 1 ile kullanıcı tarafından girilen değer arasındaki asal sayıları hesaplamak için Eratosthenes'in Sieve'ini kullanan bir öncül görev oluşturur. Bir dizi, asal sayılar hakkındaki bilgileri tutmak için kullanılır. Dizi dizini sayıyı temsil eder ve öğenin değeri, sayın bileşik mi (değeri true
) yoksa asal mı (değeridir false
) olduğunu gösterir. Bu görev daha sonra tamsayı dizisinden asal sayıları ayıklamaktan ve bunları görüntülemekten sorumlu olan bir devamlılık görevine geçirilir.
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.
Açıklamalar
Döndürülen Task görev, geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hatadan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith(Action<Task<TResult>>, TaskScheduler)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
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
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir eylem. Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
- scheduler
- TaskScheduler
TaskScheduler devamlılık göreviyle ilişkilendirilecek ve yürütülmesi için kullanılacak.
Döndürülenler
Yeni bir devamlılık Task.
Özel durumlar
Task<TResult> yok edildi.
bağımsız continuationAction
değişkenidir null
.
-veya-
bağımsız scheduler
değişkenidir null
.
Açıklamalar
Döndürülen Task , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir işlev. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
continuation işlevi tarafından kullanılacak verileri temsil eden bir nesne.
- cancellationToken
- CancellationToken
Yeni CancellationToken göreve atanacak olan.
- continuationOptions
- TaskContinuationOptions
Devamlılık zamanlandığında ve nasıl davranacağını gösteren seçenekler. Buna gibi OnlyOnCanceledölçütlerin yanı sıra gibi yürütme seçenekleri ExecuteSynchronouslyde dahildir.
- scheduler
- TaskScheduler
TaskScheduler devamlılık göreviyle ilişkilendirilecek ve yürütülmesi için kullanılacak.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
bağımsız scheduler
değişkenidir null
.
continuationOptions
bağımsız değişkeni için TaskContinuationOptionsgeçersiz bir değer belirtir.
Sağlananlar CancellationToken zaten atılmış.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
continuationFunction
yürütülürken bir döndürmelidirTask<TResult>. Bu görevin tamamlanma durumu, çağrıdan Task<TResult>.ContinueWith döndürülen göreve aktarılır.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
içinde continuationOptions
belirtilen koşula göre yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
içinde continuationOptions
belirtilen koşula göre çalıştırılacak bir işlev.
Çalıştırıldığında, temsilci bu tamamlanan göreve bağımsız değişken olarak geçirilir.
- cancellationToken
- CancellationToken
Yeni CancellationToken göreve atanacak olan.
- continuationOptions
- TaskContinuationOptions
Devamlılık zamanlandığında ve nasıl davranacağını gösteren seçenekler. Buna gibi OnlyOnCanceledölçütlerin yanı sıra gibi yürütme seçenekleri ExecuteSynchronouslyde dahildir.
- scheduler
- TaskScheduler
TaskScheduler devamlılık göreviyle ilişkilendirilecek ve yürütülmesi için kullanılacak.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
Task<TResult> yok edildi.
-veya-
Oluşturulan CancellationTokenSourcecancellationToken
zaten atılmış.
bağımsız continuationFunction
değişkenidir null
.
-veya-
bağımsız scheduler
değişkenidir null
.
continuationOptions
bağımsız değişkeni için TaskContinuationOptionsgeçersiz bir değer belirtir.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
continuationFunction
yürütülürken bir döndürmelidirTask<TResult>.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir işlev. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
continuation işlevi tarafından kullanılacak verileri temsil eden bir nesne.
- scheduler
- TaskScheduler
TaskScheduler devamlılık göreviyle ilişkilendirilecek ve yürütülmesi için kullanılacak.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
bağımsız scheduler
değişkenidir null
.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir işlev. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
continuation işlevi tarafından kullanılacak verileri temsil eden bir nesne.
- cancellationToken
- CancellationToken
Yeni CancellationToken göreve atanacak olan.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
bağımsız continuationFunction
değişkenidir null
.
Sağlananlar CancellationToken zaten atılmış.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir işlev. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
continuation işlevi tarafından kullanılacak verileri temsil eden bir nesne.
- continuationOptions
- TaskContinuationOptions
Devamlılık zamanlandığında ve nasıl davranacağını gösteren seçenekler. Buna gibi OnlyOnCanceledölçütlerin yanı sıra gibi yürütme seçenekleri ExecuteSynchronouslyde dahildir.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
bağımsız continuationFunction
değişkenidir null
.
continuationOptions
bağımsız değişkeni için TaskContinuationOptionsgeçersiz bir değer belirtir.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
continuationFunction
yürütülürken bir döndürmelidirTask<TResult>. Bu görevin tamamlanma durumu, ContinueWith çağrısından döndürülen göreve aktarılır.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
içinde continuationOptions
belirtilen koşula göre yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
içinde continuationOptions
belirtilen koşula göre çalıştırılacak bir işlev.
Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
- continuationOptions
- TaskContinuationOptions
Devamlılık zamanlandığında ve nasıl davranacağını gösteren seçenekler. Buna gibi OnlyOnCanceledölçütlerin yanı sıra gibi yürütme seçenekleri ExecuteSynchronouslyde dahildir.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
Task<TResult> yok edildi.
bağımsız continuationFunction
değişkenidir null
.
continuationOptions
bağımsız değişkeni için TaskContinuationOptionsgeçersiz bir değer belirtir.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
continuationFunction
yürütülürken bir döndürmelidirTask<TResult>.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir işlev. Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
- cancellationToken
- CancellationToken
Yeni CancellationToken göreve atanacak olan.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
Task<TResult> yok edildi.
-veya-
Oluşturulan CancellationTokenSourcecancellationToken
zaten atılmış.
bağımsız continuationFunction
değişkenidir null
.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir işlev. Çalıştırıldığında, temsilci tamamlanmış göreve ve çağıran tarafından sağlanan durum nesnesine bağımsız değişken olarak geçirilir.
- state
- Object
continuation işlevi tarafından kullanılacak verileri temsil eden bir nesne.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
bağımsız continuationFunction
değişkenidir null
.
Örnekler
Aşağıdaki örnek bir devamlılık görevleri zinciri oluşturur. Her görev, yönteminin durum bağımsız değişkeni için geçerli saati (nesne DateTime ) ContinueWith(Action<Task,Object>, Object) sağlar. Her DateTime değer, devam görevinin oluşturulduğu zamanı temsil eder. Her görev sonucu olarak, görevin bitiş zamanını temsil eden ikinci DateTime bir değer üretir. Tüm görevler tamamlandıktan sonra, örnekte her devamlılık görevinin başlatıldığı ve tamamlandığı tarih ve saatler görüntülenir.
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.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir işlev. Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
Task<TResult> yok edildi.
bağımsız continuationFunction
değişkenidir null
.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama
Şunlara uygulanır
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
- Kaynak:
- Future.cs
Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
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)
Tür Parametreleri
- TNewResult
Devamlılık tarafından üretilen sonucun türü.
Parametreler
tamamlandığında çalıştırılacak Task<TResult> bir işlev. Çalıştırıldığında, temsilci tamamlanmış göreve bağımsız değişken olarak geçirilir.
- scheduler
- TaskScheduler
TaskScheduler devamlılık göreviyle ilişkilendirilecek ve yürütülmesi için kullanılacak.
Döndürülenler
Yeni bir devamlılık Task<TResult>.
Özel durumlar
Task<TResult> yok edildi.
bağımsız continuationFunction
değişkenidir null
.
-veya-
bağımsız scheduler
değişkenidir null
.
Açıklamalar
Döndürülen Task<TResult> , geçerli görev tamamlanana kadar yürütülmek üzere zamanlanmaz; tamamlanmak üzere başarıyla çalıştırıldığından, işlenmeyen bir özel durumdan dolayı hataya neden olduğundan veya iptal edildiği için erken çıkıldığında tamamlanır.
Ayrıca bkz.
- TaskScheduler
- Görev Paralel Kitaplığı (TPL)
- Görev Tabanlı Zaman Uyumsuz Programlama
- Devamlılık Görevlerini Kullanarak Görevleri Birbirine Bağlama