Task Sınıf
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.
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ür |
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 |
Run(Func<Task>, CancellationToken) |
Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve tarafından |
Run<TResult>(Func<Task<TResult>>) |
Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve tarafından |
Run<TResult>(Func<Task<TResult>>, CancellationToken) |
Belirtilen çalışmayı iş parçacığı havuzunda çalışacak şekilde kuyruğa alır ve tarafından |
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 |
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(IEnumerable<Task>, CancellationToken) |
Zaman uyumsuz bir işlemi temsil eder. |
WaitAll(ReadOnlySpan<Task>) |
Zaman uyumsuz bir işlemi temsil eder. |
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(ReadOnlySpan<Task>) |
Zaman uyumsuz bir işlemi temsil eder. |
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>(ReadOnlySpan<Task<TResult>>) |
Zaman uyumsuz bir işlemi temsil eder. |
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(ReadOnlySpan<Task>) |
Zaman uyumsuz bir işlemi temsil eder. |
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>(ReadOnlySpan<Task<TResult>>) |
Zaman uyumsuz bir işlemi temsil eder. |
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. |
WhenEach(IEnumerable<Task>) |
Zaman uyumsuz bir işlemi temsil eder. |
WhenEach(ReadOnlySpan<Task>) |
Zaman uyumsuz bir işlemi temsil eder. |
WhenEach(Task[]) |
Zaman uyumsuz bir işlemi temsil eder. |
WhenEach<TResult>(IEnumerable<Task<TResult>>) |
Zaman uyumsuz bir işlemi temsil eder. |
WhenEach<TResult>(ReadOnlySpan<Task<TResult>>) |
Zaman uyumsuz bir işlemi temsil eder. |
WhenEach<TResult>(Task<TResult>[]) |
Zaman uyumsuz bir işlemi temsil eder. |
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) |
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.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin