Task<TResult> Sınıf

Tanım

Ad Alanı:

System.Threading.Tasks

Bütünleştirilmiş Kod:

System.Runtime.dll

Source:

Future.cs

Değer döndürebilen zaman uyumsuz bir işlemi temsil eder.

generic <typename TResult>
public ref class Task : System::Threading::Tasks::Task

public class Task<TResult> : System.Threading.Tasks.Task

type Task<'Result> = class
    inherit Task

Public Class Task(Of TResult)
Inherits Task

Tür Parametreleri

TResult

Bu Task<TResult>tarafından üretilen sonucun türü.

Devralma

Object

Task

Task<TResult>

Açıklamalar

sınıfı, Task<TResult> bir değer döndüren ve genellikle zaman uyumsuz olarak yürütülen tek bir işlemi temsil eder. Task<TResult>nesneleri, ilk olarak .NET Framework 4'te tanıtılan görev tabanlı zaman uyumsuz desenin merkezi bileşenlerinden biridir. Bir Task<TResult> nesne tarafından gerçekleştirilen iş genellikle ana uygulama iş parçacığında zaman uyumlu olarak değil, bir iş parçacığı havuzu iş parçacığında zaman uyumsuz olarak yürütülür, bir görevin durumunu belirlemek için , IsCompletedve IsFaulted özelliklerinin yanı IsCanceledsıra özelliğini de kullanabilirsinizStatus. En yaygın olarak, görevin gerçekleştireceğiniz çalışmayı belirtmek için bir lambda ifadesi kullanılır.

Task<TResult> örnekleri çeşitli yollarla oluşturulabilir. .NET Framework 4.5 ile başlayan en yaygın yaklaşım statik veya Task.Run<TResult>(Func<TResult>, CancellationToken) yöntemi çağırmaktırTask.Run<TResult>(Func<TResult>). Bu yöntemler, varsayılan değerleri kullanarak ve ek parametreler almadan bir görevi başlatmak için basit bir yol sağlar. Aşağıdaki örnek, döngüye girip Task.Run<TResult>(Func<TResult>) döngü yinelemelerinin sayısını görüntüleyen bir görevi başlatmak için yöntemini kullanır:

using System;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var t = Task<int>.Run( () => {
                                      // Just loop.
                                      int max = 1000000;
                                      int ctr = 0;
                                      for (ctr = 0; ctr <= max; ctr++) {
                                         if (ctr == max / 2 && DateTime.Now.Hour <= 12) {
                                            ctr++;
                                            break;
                                         }
                                      }
                                      return ctr;
                                    } );
      Console.WriteLine("Finished {0:N0} iterations.", t.Result);
   }
}
// The example displays output like the following:
//        Finished 1,000,001 loop iterations.

Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim t As Task(Of Integer) = Task.Run(Function()
                                  Dim max As Integer = 1000000
                                  Dim ctr As Integer
                                  For ctr = 0 to max
                                     If ctr = max \ 2 And Date.Now.Hour <= 12 Then
                                        ctr += 1
                                        Exit For
                                     End If
                                  Next
                                  Return ctr
                               End Function)
      Console.WriteLine("Finished {0:N0} iterations.", t.Result)
   End Sub
End Module
' The example displays the following output:
'       Finished 1,000,001 loop iterations

Alternatif olarak .NET Framework 4'te bir görevi başlatmanın en yaygın yolu statik TaskFactory.StartNew veya TaskFactory<TResult>.StartNew yöntemi çağırmaktır. Task.Factory özelliği bir TaskFactory nesnesi döndürür ve Task<TResult>.Factory özelliği bir TaskFactory<TResult> nesnesi döndürür. Yöntemlerinin aşırı yüklemeleri StartNew bağımsız değişkenleri geçirmenize, görev oluşturma seçeneklerini tanımlamanıza ve bir görev zamanlayıcı belirtmenize olanak sağlar. Aşağıdaki örnek, bir görevi başlatmak için yöntemini kullanır TaskFactory<TResult>.StartNew(Func<TResult>) . İşlevsel olarak önceki örnekteki koda eşdeğerdir.

using System;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var t = Task<int>.Factory.StartNew( () => {
                                      // Just loop.
                                      int max = 1000000;
                                      int ctr = 0;
                                      for (ctr = 0; ctr <= max; ctr++) {
                                         if (ctr == max / 2 && DateTime.Now.Hour <= 12) {
                                            ctr++;
                                            break;
                                         }
                                      }
                                      return ctr;
                               } );
      Console.WriteLine("Finished {0:N0} iterations.", t.Result);
   }
}
// The example displays the following output:
//        Finished 1000001 loop iterations

Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim t = Task(Of Integer).Factory.StartNew(Function()
                                  Dim max As Integer = 1000000
                                  Dim ctr As Integer
                                  For ctr = 0 to max
                                     If ctr = max \ 2 And Date.Now.Hour <= 12 Then
                                       ctr += 1
                                       Exit For
                                     End If
                                  Next
                                  Return ctr
                               End Function)
      Console.WriteLine("Finished {0:N0} iterations.", t.Result)
   End Sub
End Module
' The example displays output like the following:
'       Finished 1,000,001 iterations

Daha eksiksiz örnekler için bkz . Görev Tabanlı Zaman Uyumsuz Programlama.

sınıfı, Task<TResult> görevi başlatan ancak yürütme için zamanlamayan oluşturucular da sağlar. Performans nedenleriyle, Task.Run ve Task.Factory.StartNew yöntemleri hesaplama görevlerini oluşturmak ve zamanlamak için tercih edilen mekanizmalardır, ancak görev oluşturma ve zamanlamanın ayrılması gereken senaryolar için oluşturucular kullanılabilir ve görevin Start yöntemi daha sonra yürütülecek görevi zamanlamak için kullanılabilir.

.NET Framework 4.6'yı hedefleyen masaüstü uygulamalarından başlayarak, bir görevi oluşturan ve çağıran iş parçacığının kültürü iş parçacığı bağlamının bir parçası olur. Yani, görevin yürütülürken iş parçacığının geçerli kültürü ne olursa olsun, görevin geçerli kültürü çağıran iş parçacığının kültürüdür. .NET Framework 4.6'dan önceki .NET Framework sürümlerini hedefleyen uygulamalar için, görevin kültürü görevin yürütülürken iş parçacığının kültürüdür. Daha fazla bilgi için konunun "Kültür ve görev tabanlı zaman uyumsuz işlemler" bölümüne CultureInfo bakın. Mağaza uygulamalarının varsayılan kültürü ayarlama ve alma Windows Çalışma Zamanı izlediğini unutmayın.

Değer döndürmeyen işlemler için sınıfını Task kullanırsınız. C# 7.0'dan başlayarak, başvuru türü yerine değer türü olan daha basit bir görev için yapısını kullanın System.Threading.Tasks.ValueTask<TResult> .

Oluşturucular

Task<TResult>(Func<Object,TResult>, Object)	Belirtilen işlev ve durumla yeni Task<TResult> bir başlatır.
Task<TResult>(Func<Object,TResult>, Object, CancellationToken)	Belirtilen eylem, durum ve seçeneklerle yeni Task<TResult> bir başlatır.
Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)	Belirtilen eylem, durum ve seçeneklerle yeni Task<TResult> bir başlatır.
Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)	Belirtilen eylem, durum ve seçeneklerle yeni Task<TResult> bir başlatır.
Task<TResult>(Func<TResult>)	Belirtilen işlevle yeni Task<TResult> bir başlatır.
Task<TResult>(Func<TResult>, CancellationToken)	Belirtilen işlevle yeni Task<TResult> bir başlatır.
Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)	Belirtilen işlev ve oluşturma seçenekleriyle yeni Task<TResult> bir başlatır.
Task<TResult>(Func<TResult>, TaskCreationOptions)	Belirtilen işlev ve oluşturma seçenekleriyle yeni Task<TResult> bir başlatır.

Özellikler

AsyncState	oluşturulduktan sonra sağlanan durum nesnesini veya sağlanmazsa Task null değerini alır. (Devralındığı yer: Task)
CreationOptions	Bu görevi oluşturmak için kullanılan öğesini TaskCreationOptions alır. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
Factory	Örnekleri oluşturmak ve yapılandırmak Task<TResult> için bir fabrika yöntemi alır.
Id	Bu Task örnek için bir kimlik alır. (Devralındığı yer: Task)
IsCanceled	Bu Task örneğin iptal edildiği için yürütmeyi tamamlayıp tamamlamadığını alır. (Devralındığı yer: Task)
IsCompleted	Görevin tamamlanıp tamamlanmadığını gösteren bir değer alır. (Devralındığı yer: Task)
IsCompletedSuccessfully	Görevin tamamlanmak üzere çalıştırılıp çalıştırılmadığını alır. (Devralındığı yer: Task)
IsFaulted	İşlenmeyen Task bir özel durum nedeniyle tamamlanıp tamamlanmadığını alır. (Devralındığı yer: Task)
Result	Bu Task<TResult>değerinin sonuç değerini alır.
Status	Bu görevin değerini TaskStatus alır. (Devralındığı yer: Task)

Yöntemler

ConfigureAwait(Boolean)	Bunu Task<TResult>beklemek 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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
ContinueWith(Action<Task<TResult>,Object>, Object)	Durum bilgileri geçirilen ve hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>>)	Hedef görev tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>>, CancellationToken)	Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen iptal edilebilir bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)	içinde continuationOptionsbelirtilen koşula göre yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)	içinde continuationOptionsbelirtilen koşula göre yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task<TResult>>, TaskScheduler)	Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
ContinueWith(Action<Task>)	Hedef Task tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
ContinueWith(Action<Task>, TaskContinuationOptions)	Hedef görev belirtilen TaskContinuationOptionsdeğerine göre tamamlandığında yürütülen bir devamlılık oluşturur. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)	Hedef Task<TResult> tamamlandığında yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)	Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)	Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	içinde continuationOptionsbelirtilen koşula göre yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)	içinde continuationOptionsbelirtilen koşula göre yürütülen bir devamlılık oluşturur.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)	Hedef Task<TResult> tamamlandığında zaman uyumsuz olarak yürütülen bir devamlılık oluşturur.
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
Dispose()	Task sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Task)
Dispose(Boolean)	Taskyönetilmeyen kaynaklarının tümünü serbest bırakarak öğesini atmış olur. (Devralındığı yer: Task)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetAwaiter()	Bunu Task<TResult>beklemek 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)
RunSynchronously()	geçerli TaskTaskSchedulerüzerinde zaman uyumlu olarak çalıştırır. (Devralındığı yer: Task)
RunSynchronously(TaskScheduler)	sağlanan Task üzerinde TaskScheduler zaman uyumlu olarak çalıştırır. (Devralındığı yer: Task)
Start()	Taskgeçerli TaskScheduleröğesine yürütülmek üzere zamanlayarak öğesini başlatır. (Devralındığı yer: Task)
Start(TaskScheduler)	belirtilen TaskScheduleröğesine Taskyürütülmek üzere zamanlayarak öğesini başlatır. (Devralındığı yer: Task)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
Wait()	yürütmenin Task tamamlanmasını bekler. (Devralındığı yer: Task)
Wait(CancellationToken)	yürütmenin Task tamamlanmasını bekler. Görev tamamlanmadan önce iptal belirteci iptal edilirse bekleme sonlandırılır. (Devralındığı yer: Task)
Wait(Int32)	belirtilen milisaniye içinde yürütmenin Task tamamlanmasını bekler. (Devralındığı yer: Task)
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. (Devralındığı yer: Task)
Wait(TimeSpan)	Yürütmenin Task belirli bir zaman aralığı içinde tamamlanmasını bekler. (Devralındığı yer: Task)
Wait(TimeSpan, CancellationToken)	yürütmenin Task tamamlanmasını bekler. (Devralındığı yer: Task)
WaitAsync(CancellationToken)	Bu Task<TResult> tamamlandığında veya belirtilen CancellationToken iptal istendiğinde tamamlanacak bir Task<TResult> alır.
WaitAsync(TimeSpan)	Bu Task<TResult> tamamlandığında veya belirtilen zaman aşımı sona erdiğinde tamamlanacak bir Task<TResult> alır.
WaitAsync(TimeSpan, CancellationToken)	Bu Task<TResult> tamamlandığında, belirtilen zaman aşımı sona erdiğinde veya belirtilen CancellationToken iptal istendiğinde tamamlanacak bir Task<TResult> alır.
WaitAsync(TimeSpan, TimeProvider)	Bu Task<TResult> tamamlandığında veya belirtilen zaman aşımı sona erdiğinde tamamlanacak bir Task<TResult> alır.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Bu Task<TResult> tamamlandığında, belirtilen zaman aşımı sona erdiğinde veya belirtilen CancellationToken iptal istendiğinde tamamlanacak bir Task<TResult> alır.

Belirtik Arabirim Kullanımları

IAsyncResult.AsyncWaitHandle	Görevin tamamlanmasını beklemek için kullanılabilecek bir WaitHandle alır. (Devralındığı yer: Task)
IAsyncResult.CompletedSynchronously	İşlemin zaman uyumlu olarak tamamlanıp tamamlanmadığına ilişkin bir gösterge alır. (Devralındığı yer: Task)

Uzantı Metotları

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

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

Ayrıca bkz.

• Task
• Görev Paralel Kitaplığı (TPL)
• Görev Tabanlı Zaman Uyumsuz Programlama
• .NET Core ve .NET Standard ile Paralel Programlama Örnekleri