Task Sınıf

Tanım

Ad Alanı:

System.Threading.Tasks

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Task.cs

Zaman uyumsuz bir işlemi temsil eder.

public ref class Task : IAsyncResult, IDisposable

public class Task : IAsyncResult, IDisposable

type Task = class
    interface IAsyncResult
    interface IDisposable

Public Class Task
Implements IAsyncResult, IDisposable

Devralma

Object

Task

Türetilmiş

System.Threading.Tasks.Task<TResult>

Uygulamalar

IAsyncResult IDisposable

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(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(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>(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(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>(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.
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ı

AsyncWait<TException>(Task)	Zaman uyumsuz bir işlemi temsil eder.
AwaitWithTimeout(Task, TimeSpan)	Zaman uyumsuz bir işlemi temsil eder.
ToApm(Task, AsyncCallback, Object)	Zaman uyumsuz bir işlemi temsil eder.
ToApmEnd(IAsyncResult)	Zaman uyumsuz bir işlemi temsil eder.
ToApmEnd<TResult>(IAsyncResult)	Zaman uyumsuz bir işlemi temsil eder.
Wait(Task, TimeSpan, Action<Exception,TimeSpan,String>, String)	Zaman uyumsuz bir işlemi temsil eder.
WaitForCompletion(Task)	Zaman uyumsuz bir işlemi temsil eder.
WaitForCompletionNoSpin(Task)	Zaman uyumsuz bir işlemi temsil eder.
WaitForCompletionNoSpin(Task, TimeSpan)	Zaman uyumsuz bir işlemi temsil eder.
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.

İş 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.

• Task<TResult>
• Görev Paralel Kitaplığı (TPL)
• .NET'te görev tabanlı zaman uyumsuz deseni (TAP) : Giriş ve genel bakış
• Görev Tabanlı Zaman Uyumsuz Programlama
• .NET Core ve .NET Standard ile Paralel Programlama için Örnekleri