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örev için ek API açıklamaları.

Oluşturucular

Task(Action)

Belirtilen eylemle yeni Task bir başlatır.

Task(Action, CancellationToken)

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

Task(Action, CancellationToken, TaskCreationOptions)

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

Task(Action, TaskCreationOptions)

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

Task(Action<Object>, Object)

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

Task(Action<Object>, Object, CancellationToken)

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

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

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

Task(Action<Object>, Object, TaskCreationOptions)

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

Özellikler

AsyncState

oluşturulduktan sonra sağlanan durum nesnesini veya sağlanmazsa Task 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 öğesini TaskCreationOptions alır.

CurrentId

Şu anda yürütülmekte Taskolan öğesinin kimliğini döndürür.

Exception

AggregateException Erken sona ermesini sağlayan öğesini Task alır. Task başarıyla tamamlandıysa veya henüz herhangi bir özel durum oluşturduysa, bu döndürürnull.

Factory

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

Id

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

IsCanceled

Bu Task örneğin iptal edildiği için yürütmeyi tamamlayıp tamamlamadığı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 Task bir özel durum nedeniyle tamamlanıp tamamlanmadığını alır.

Status

Bu görevin değerini TaskStatus alır.

Yöntemler

ConfigureAwait(Boolean)

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

ConfigureAwait(ConfigureAwaitOptions)

Bunu 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 bir 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. Devamlılık, 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)

İptal belirteci alan ve hedef Task tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.

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

Hedef görev belirtilen TaskContinuationOptionsdeğerine gö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 TaskContinuationOptionsdeğerine gö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 zaman uyumsuz olarak yürütülen ve bir değer döndüren 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, arayan 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 zaman uyumsuz olarak yürütülen ve bir değer döndüren bir devamlılık oluşturur.

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

Hedef Task tamamlandığında zaman uyumsuz olarak yürütülen ve bir değer döndüren 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. Devamlılık bir iptal belirteci geçirilir ve belirtilen zamanlayıcıyı kullanı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 zaman uyumsuz olarak yürütülen ve bir değer döndüren 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 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)

Taskyönetilmeyen kaynaklarının tümünü serbest bırakarak öğesini atmış olur.

Equals(Object)

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

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

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

FromCanceled<TResult>(CancellationToken)

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

FromException(Exception)

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

FromException<TResult>(Exception)

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

FromResult<TResult>(TResult)

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

GetAwaiter()

Bunu 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()

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

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

Geçerli Objectöğesinin sığ 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 nesne 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 nesne 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 tarafından functiondö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 tarafından functiondö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 tarafından functiondöndürülen için Task(TResult) 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 tarafından functiondöndürülen için Task(TResult) 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> nesne 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) nesne döndürür.

RunSynchronously()

geçerli TaskTaskSchedulerüzerinde zaman uyumlu olarak çalıştırır.

RunSynchronously(TaskScheduler)

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

Start()

Taskgeçerli TaskScheduleröğesine yürütülmek üzere zamanlayarak öğesini başlatır.

Start(TaskScheduler)

belirtilen TaskScheduleröğesine Taskyürütülmek üzere zamanlayarak öğesini başlatır.

ToString()

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

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

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

Wait(CancellationToken)

yürütmenin Task 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)

yürütmenin Task 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)

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

Wait(TimeSpan, CancellationToken)

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

WaitAll(Task[])

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

WaitAll(Task[], CancellationToken)

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

WaitAll(Task[], Int32)

Belirtilen Task sayıda milisaniye içinde sağlanan tüm nesnelerin yürütülmesini bekler.

WaitAll(Task[], Int32, CancellationToken)

Belirtilen sayıda milisaniye içinde veya bekleme iptal edilene kadar sağlanan Task tüm nesnelerin yürütülmesini bekler.

WaitAll(Task[], TimeSpan)

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

WaitAny(Task[])

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

WaitAny(Task[], CancellationToken)

Bekleme iptal edilmediği sürece sağlanan Task nesnelerden herhangi birinin yürütmeyi tamamlamasını bekler.

WaitAny(Task[], Int32)

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

WaitAny(Task[], Int32, CancellationToken)

Belirtilen sayıda milisaniye içinde veya iptal belirteci iptal edilene kadar sağlanan Task nesnelerden herhangi birinin yürütülmesini bekler.

WaitAny(Task[], TimeSpan)

Sağlanan Task nesnelerden herhangi birinin belirli bir zaman aralığı içinde yürütmeyi tamamlaması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 Task tüm nesneler tamamlandığında tamamlanacak bir görev oluşturur.

WhenAll(Task[])

Bir dizideki Task tüm nesneler tamamlandığında tamamlanacak bir görev oluşturur.

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

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

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

Bir dizideki Task<TResult> tüm nesneler 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(Task, Task)

Sağlanan görevlerden herhangi 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>(Task<TResult>, Task<TResult>)

Sağlanan görevlerden herhangi 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.

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)

Zaman uyumsuz bir işlemi temsil eder.

DispatcherOperationWait(Task)

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

DispatcherOperationWait(Task, TimeSpan)

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

IsDispatcherOperationTask(Task)

Bunun Task bir ile ilişkili olup olmadığını gösteren bir DispatcherOperationdeğer döndürür.

AsAsyncAction(Task)

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

Şunlara uygulanır

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

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

Ayrıca bkz.