Task Sınıf

Tanım

Zaman uyumsuz bir işlemi temsil eder.

public ref class Task : IAsyncResult
public ref class Task : IAsyncResult, IDisposable
public class Task : IAsyncResult
public class Task : IAsyncResult, IDisposable
type Task = class
    interface IAsyncResult
type Task = class
    interface IAsyncResult
    interface IDisposable
Public Class Task
Implements IAsyncResult
Public Class Task
Implements IAsyncResult, IDisposable
Devralma
Task
Türetilmiş
Uygulamalar

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. Göreviçin ek API açıklamaları .

Oluşturucular

Task(Action)

Belirtilen eylemle yeni bir Task başlatır.

Task(Action, CancellationToken)

Belirtilen eylem ve CancellationTokenile yeni bir Task başlatır.

Task(Action, CancellationToken, TaskCreationOptions)

Belirtilen eylem ve oluşturma seçenekleriyle yeni bir Task başlatır.

Task(Action, TaskCreationOptions)

Belirtilen eylem ve oluşturma seçenekleriyle yeni bir Task başlatır.

Task(Action<Object>, Object)

Belirtilen eylem ve durumla yeni bir Task başlatır.

Task(Action<Object>, Object, CancellationToken)

Belirtilen eylem, durum ve CancellationTokenile yeni bir Task başlatır.

Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Belirtilen eylem, durum ve seçeneklerle yeni bir Task başlatır.

Task(Action<Object>, Object, TaskCreationOptions)

Belirtilen eylem, durum ve seçeneklerle yeni bir Task başlatır.

Özellikler

AsyncState

Task oluşturulduğunda sağlanan durum nesnesini veya sağlanmadıysa null değerini alır.

CompletedTask

Başarıyla tamamlanmış bir görevi alır.

CreationOptions

Bu görevi oluşturmak için kullanılan TaskCreationOptions alır.

CurrentId

şu anda yürütülmekte olan Taskkimliğini döndürür.

Exception

Task erken bitmesini sağlayan AggregateException alır. Task başarıyla tamamlandıysa veya henüz herhangi bir özel durum oluşturduysa, bu nulldöndürür.

Factory

Task ve Task<TResult> örnekleri oluşturmak ve yapılandırmak için fabrika yöntemlerine erişim sağlar.

Id

Bu Task örneği için bir kimlik alır.

IsCanceled

bu Task örneğin iptal edildiği için yürütmenin tamamlanıp tamamlanmadığını alır.

IsCompleted

Görevin tamamlanıp tamamlanmadığını gösteren bir değer alır.

IsCompletedSuccessfully

Görevin tamamlanmak üzere çalıştırılıp çalıştırılmadığını alır.

IsFaulted

İşlenmeyen bir özel durum nedeniyle Task tamamlanıp tamamlanmadığını alır.

Status

Bu görevin TaskStatus alır.

Yöntemler

ConfigureAwait(Boolean)

Bu Taskbeklemek için kullanılan bir awaiter yapılandırılır.

ConfigureAwait(ConfigureAwaitOptions)

Bu Taskbeklemek için kullanılan bir awaiter yapılandırılır.

ContinueWith(Action<Task,Object>, Object)

Çağıran tarafından sağlanan durum bilgilerini alan ve hedef Task tamamlandığında yürütülen bir devamlılık oluşturur.

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

Çağıran tarafından sağlanan durum bilgilerini ve iptal belirtecini alan ve hedef Task tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.

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

Çağıran tarafından sağlanan durum bilgilerini ve iptal belirtecini alan ve hedef Task tamamlandığında yürütülen bir devamlılık oluşturur. Devamlılık, belirtilen koşullar kümesine göre yürütülür ve belirtilen zamanlayıcıyı kullanır.

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

Çağıran tarafından sağlanan durum bilgilerini alan ve hedef Task tamamlandığında yürütülen bir devamlılık oluşturur. Devam, belirtilen koşullar kümesine göre yürütülür.

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

Çağıran tarafından sağlanan durum bilgilerini alan ve hedef Task tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur. Devamlılık, belirtilen bir zamanlayıcıyı kullanır.

ContinueWith(Action<Task>)

Hedef Task tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.

ContinueWith(Action<Task>, CancellationToken)

bir iptal belirteci alan ve hedef Task tamamlandığında zaman uyumsuz olarak yürüten bir devamlılık oluşturur.

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

Hedef görev belirtilen TaskContinuationOptionsgöre rekabet ettiğinde yürütülen bir devamlılık oluşturur. Devamlılık bir iptal belirteci alır ve belirtilen zamanlayıcıyı kullanır.

ContinueWith(Action<Task>, TaskContinuationOptions)

Hedef görev belirtilen TaskContinuationOptionsgöre tamamlandığında yürütülen bir devamlılık oluşturur.

ContinueWith(Action<Task>, TaskScheduler)

Hedef Task tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur. Devamlılık, belirtilen bir zamanlayıcıyı kullanır.

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

Çağıran tarafından sağlanan durum bilgilerini alan ve hedef Task tamamlanıp bir değer döndürdüğünde zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.

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

Hedef Task tamamlandığında ve bir değer döndürdüğünde zaman uyumsuz olarak yürütülen bir devamlılık oluşturur. Devamlılık, arayan tarafından sağlanan durum bilgilerini ve bir iptal belirtecini alır.

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

Hedef Task tamamlandığında ve bir değer döndürdüğünde belirtilen görev devamlılığı seçeneklerine göre yürütülen bir devamlılık oluşturur. Devamlılık, çağıran tarafından sağlanan durum bilgilerini ve bir iptal belirtecini alır ve belirtilen zamanlayıcıyı kullanır.

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

Hedef Task tamamlandığında belirtilen görev devamlılığı seçeneklerine göre yürütülen bir devamlılık oluşturur. Devamlılık, arayan tarafından sağlanan durum bilgilerini alır.

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

Hedef Task tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur. Devamlılık, çağıran tarafından sağlanan durum bilgilerini alır ve belirtilen zamanlayıcıyı kullanır.

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

Hedef Task<TResult> tamamlandığında ve bir değer döndürdüğünde zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.

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

Hedef Task tamamlandığında ve bir değer döndürdüğünde zaman uyumsuz olarak yürütülen bir devamlılık oluşturur. Devamlılık bir iptal belirteci alır.

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

Belirtilen devamlılık seçeneklerine göre yürütülen ve bir değer döndüren bir devamlılık oluşturur. Devama bir iptal belirteci geçirilir ve belirtilen bir zamanlayıcı kullanılır.

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

Belirtilen devamlılık seçeneklerine göre yürütülen ve bir değer döndüren bir devamlılık oluşturur.

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

Hedef Task tamamlandığında ve bir değer döndürdüğünde zaman uyumsuz olarak yürütülen bir devamlılık oluşturur. Devamlılık, belirtilen bir zamanlayıcıyı kullanır.

Delay(Int32)

Belirtilen sayıda milisaniyeden sonra tamamlanan bir görev oluşturur.

Delay(Int32, CancellationToken)

Belirtilen sayıda milisaniyeden sonra tamamlanan iptal edilebilir bir görev oluşturur.

Delay(TimeSpan)

Belirtilen zaman aralığından sonra tamamlanan bir görev oluşturur.

Delay(TimeSpan, CancellationToken)

Belirtilen zaman aralığından sonra tamamlanan iptal edilebilir bir görev oluşturur.

Delay(TimeSpan, TimeProvider)

Belirtilen zaman aralığından sonra tamamlanan bir görev oluşturur.

Delay(TimeSpan, TimeProvider, CancellationToken)

Belirtilen zaman aralığından sonra tamamlanan iptal edilebilir bir görev oluşturur.

Dispose()

Task sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır.

Dispose(Boolean)

tüm yönetilmeyen kaynaklarını serbest bırakarak Taskatılır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FromCanceled(CancellationToken)

Belirtilen iptal belirteciyle iptal nedeniyle tamamlanan bir Task oluşturur.

FromCanceled<TResult>(CancellationToken)

Belirtilen iptal belirteciyle iptal nedeniyle tamamlanan bir Task<TResult> oluşturur.

FromException(Exception)

Belirtilen özel durumla tamamlanmış bir Task oluşturur.

FromException<TResult>(Exception)

Belirtilen özel durumla tamamlanmış bir Task<TResult> oluşturur.

FromResult<TResult>(TResult)

Belirtilen sonuçla başarıyla tamamlanan bir Task<TResult> oluşturur.

GetAwaiter()

Bu Taskbeklemek için kullanılan bir awaiter alır.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
Run(Action)

Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve bu çalışmayı temsil eden bir Task nesnesi döndürür.

Run(Action, CancellationToken)

Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve bu çalışmayı temsil eden bir Task nesnesi döndürür. İptal belirteci, henüz başlatılmamışsa çalışmanın iptal edilmesini sağlar.

Run(Func<Task>)

Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve functiontarafından döndürülen görev için bir ara sunucu döndürür.

Run(Func<Task>, CancellationToken)

Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve functiontarafından döndürülen görev için bir ara sunucu döndürür. İptal belirteci, henüz başlatılmamışsa çalışmanın iptal edilmesini sağlar.

Run<TResult>(Func<Task<TResult>>)

Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve functiontarafından döndürülen Task(TResult) için bir ara sunucu döndürür. İptal belirteci, henüz başlatılmamışsa çalışmanın iptal edilmesini sağlar.

Run<TResult>(Func<Task<TResult>>, CancellationToken)

Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve functiontarafından döndürülen Task(TResult) için bir ara sunucu döndürür.

Run<TResult>(Func<TResult>)

Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve bu çalışmayı temsil eden bir Task<TResult> nesnesi döndürür. İptal belirteci, henüz başlatılmamışsa çalışmanın iptal edilmesini sağlar.

Run<TResult>(Func<TResult>, CancellationToken)

Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve bu çalışmayı temsil eden bir Task(TResult) nesnesi döndürür.

RunSynchronously()

Task geçerli TaskSchedulerzaman uyumlu olarak çalıştırır.

RunSynchronously(TaskScheduler)

Task sağlanan TaskScheduler zaman uyumlu olarak çalıştırır.

Start()

Taskbaşlatır ve geçerli TaskScheduleryürütülmek üzere zamanlar.

Start(TaskScheduler)

Taskbaşlatır ve belirtilen TaskScheduleryürütülmek üzere zamanlar.

ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)
Wait()

Task yürütmenin tamamlanmasını bekler.

Wait(CancellationToken)

Task yürütmenin tamamlanmasını bekler. Görev tamamlanmadan önce iptal belirteci iptal edilirse bekleme sonlandırılır.

Wait(Int32)

Task belirtilen sayıda milisaniye içinde yürütmenin tamamlanmasını bekler.

Wait(Int32, CancellationToken)

Task yürütmenin tamamlanmasını bekler. Görev tamamlanmadan önce bir zaman aşımı aralığı geçtiğinde veya iptal belirteci iptal edilirse bekleme sonlandırılır.

Wait(TimeSpan)

Task belirli bir zaman aralığı içinde yürütmenin tamamlanmasını bekler.

Wait(TimeSpan, CancellationToken)

Task yürütmenin tamamlanmasını bekler.

WaitAll(IEnumerable<Task>, CancellationToken)

Bekleme iptal edilmediği sürece sağlanan tüm Task nesnelerinin yürütülmesini bekler.

WaitAll(ReadOnlySpan<Task>)

Sağlanan tüm Task nesnelerinin yürütülmesini bekler.

WaitAll(Task[])

Sağlanan tüm Task nesnelerinin yürütülmesini bekler.

WaitAll(Task[], CancellationToken)

Bekleme iptal edilmediği sürece sağlanan tüm Task nesnelerinin yürütülmesini bekler.

WaitAll(Task[], Int32)

Sağlanan tüm Task nesnelerinin belirtilen sayıda milisaniye içinde yürütülmesini bekler.

WaitAll(Task[], Int32, CancellationToken)

Sağlanan tüm Task nesnelerinin belirtilen sayıda milisaniye içinde veya bekleme iptal edilene kadar yürütmeyi tamamlanmasını bekler.

WaitAll(Task[], TimeSpan)

Sağlanan tüm iptal edilebilir Task nesnelerinin belirli bir zaman aralığı içinde yürütülmesini bekler.

WaitAny(Task[])

Sağlanan Task nesnelerinden herhangi birinin yürütülmesini bekler.

WaitAny(Task[], CancellationToken)

Bekleme iptal edilmediği sürece sağlanan Task nesnelerinden herhangi birinin yürütülmesini bekler.

WaitAny(Task[], Int32)

Sağlanan Task nesnelerinden herhangi birinin belirtilen sayıda milisaniye içinde yürütmeyi tamamlanmasını bekler.

WaitAny(Task[], Int32, CancellationToken)

Sağlanan Task nesnelerinden herhangi birinin belirtilen sayıda milisaniye içinde veya iptal belirteci iptal edilene kadar yürütmenin tamamlanmasını bekler.

WaitAny(Task[], TimeSpan)

Sağlanan Task nesnelerinden herhangi birinin belirtilen zaman aralığında yürütmeyi tamamlanmasını bekler.

WaitAsync(CancellationToken)

Bu Task tamamlandığında veya belirtilen CancellationToken iptal istendiğinde tamamlanacak bir Task alır.

WaitAsync(TimeSpan)

Bu Task tamamlandığında veya belirtilen zaman aşımı sona erdiğinde tamamlanacak bir Task alır.

WaitAsync(TimeSpan, CancellationToken)

Bu Task tamamlandığında, belirtilen zaman aşımı sona erdiğinde veya belirtilen CancellationToken iptal istendiğinde tamamlanacak bir Task alır.

WaitAsync(TimeSpan, TimeProvider)

Bu Task tamamlandığında veya belirtilen zaman aşımı sona erdiğinde tamamlanacak bir Task alır.

WaitAsync(TimeSpan, TimeProvider, CancellationToken)

Bu Task tamamlandığında, belirtilen zaman aşımı sona erdiğinde veya belirtilen CancellationToken iptal istendiğinde tamamlanacak bir Task alır.

WhenAll(IEnumerable<Task>)

Numaralandırılabilir bir koleksiyondaki tüm Task nesneleri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAll(ReadOnlySpan<Task>)

Sağlanan tüm görevler tamamlandığında tamamlanacak bir görev oluşturur.

WhenAll(Task[])

Dizideki tüm Task nesneleri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAll<TResult>(IEnumerable<Task<TResult>>)

Numaralandırılabilir bir koleksiyondaki tüm Task<TResult> nesneleri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAll<TResult>(ReadOnlySpan<Task<TResult>>)

Sağlanan tüm görevler tamamlandığında tamamlanacak bir görev oluşturur.

WhenAll<TResult>(Task<TResult>[])

Dizideki tüm Task<TResult> nesneleri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAny(IEnumerable<Task>)

Sağlanan görevlerden herhangi biri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAny(ReadOnlySpan<Task>)

Sağlanan görevlerden herhangi biri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAny(Task, Task)

Sağlanan görevlerden biri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAny(Task[])

Sağlanan görevlerden herhangi biri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAny<TResult>(IEnumerable<Task<TResult>>)

Sağlanan görevlerden herhangi biri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAny<TResult>(ReadOnlySpan<Task<TResult>>)

Sağlanan görevlerden herhangi biri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAny<TResult>(Task<TResult>, Task<TResult>)

Sağlanan görevlerden biri tamamlandığında tamamlanacak bir görev oluşturur.

WhenAny<TResult>(Task<TResult>[])

Sağlanan görevlerden herhangi biri tamamlandığında tamamlanacak bir görev oluşturur.

WhenEach(IEnumerable<Task>)

Bu görevler tamamlandıktan sonra sağlanan görevleri sağlayacak bir IAsyncEnumerable<T> oluşturur.

WhenEach(ReadOnlySpan<Task>)

Bu görevler tamamlandıktan sonra sağlanan görevleri sağlayacak bir IAsyncEnumerable<T> oluşturur.

WhenEach(Task[])

Bu görevler tamamlandıktan sonra sağlanan görevleri sağlayacak bir IAsyncEnumerable<T> oluşturur.

WhenEach<TResult>(IEnumerable<Task<TResult>>)

Bu görevler tamamlandıktan sonra sağlanan görevleri sağlayacak bir IAsyncEnumerable<T> oluşturur.

WhenEach<TResult>(ReadOnlySpan<Task<TResult>>)

Bu görevler tamamlandıktan sonra sağlanan görevleri sağlayacak bir IAsyncEnumerable<T> oluşturur.

WhenEach<TResult>(Task<TResult>[])

Bu görevler tamamlandıktan sonra sağlanan görevleri sağlayacak bir IAsyncEnumerable<T> oluşturur.

Yield()

Beklendiğinde zaman uyumsuz olarak geçerli bağlama geri döndüren beklenebilir bir görev oluşturur.

Belirtik Arabirim Kullanımları

IAsyncResult.AsyncWaitHandle

Görevin tamamlanmasını beklemek için kullanılabilecek bir WaitHandle alır.

IAsyncResult.CompletedSynchronously

İşlemin zaman uyumlu olarak tamamlanıp tamamlanmadığına ilişkin bir gösterge alır.

Uzantı Metotları

WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken)

Bu Task tamamlandığında, belirtilen zaman aşımı sona erdiğinde veya belirtilen CancellationToken iptal istendiğinde tamamlanacak bir Task alır.

DispatcherOperationWait(Task)

Temel DispatcherOperation tamamlanmasını süresiz olarak bekler.

DispatcherOperationWait(Task, TimeSpan)

Temel DispatcherOperation tamamlanması için belirtilen süreyi bekler.

IsDispatcherOperationTask(Task)

Bu Task bir DispatcherOperationile ilişkili olup olmadığını gösteren bir değer döndürür.

AsAsyncAction(Task)

Başlatılan görevi temsil eden bir Windows Çalışma Zamanı zaman uyumsuz eylemi döndürür.

Şunlara uygulanır

İş Parçacığı Güvenliği

Dispose()dışındaki tüm Tasküyeleri iş parçacığı açısından güvenlidir ve aynı anda birden çok iş parçacığından kullanılabilir.

Ayrıca bkz.