Task<TResult> Kelas

Definisi

Ruang nama:

System.Threading.Tasks

Rakitan:

System.Runtime.dll

Sumber:

Future.cs

Mewakili operasi asinkron yang dapat mengembalikan nilai.

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

Jenis parameter

TResult

Jenis hasil yang dihasilkan oleh Task<TResult>ini .

Warisan

Object

Task

Task<TResult>

Keterangan

Kelas Task<TResult> mewakili satu operasi yang mengembalikan nilai dan yang biasanya dijalankan secara asinkron. Task<TResult> objek adalah salah satu komponen pusat dari pola asinkron berbasis tugas pertama kali diperkenalkan dalam .NET Framework 4. Karena pekerjaan yang dilakukan oleh objek Task<TResult> biasanya dijalankan secara asinkron pada utas kumpulan utas daripada secara sinkron pada utas aplikasi utama, Anda dapat menggunakan properti Status, serta properti IsCanceled, IsCompleted, dan IsFaulted, untuk menentukan status tugas. Paling umum, ekspresi lambda digunakan untuk menentukan pekerjaan yang akan dilakukan tugas.

Task<TResult> instans dapat dibuat dengan berbagai cara. Pendekatan paling umum, yang tersedia dimulai dengan .NET Framework 4.5, adalah memanggil metode Task.Run<TResult>(Func<TResult>) statis atau Task.Run<TResult>(Func<TResult>, CancellationToken). Metode ini menyediakan cara sederhana untuk memulai tugas dengan menggunakan nilai default dan tanpa memperoleh parameter tambahan. Contoh berikut menggunakan metode Task.Run<TResult>(Func<TResult>) untuk memulai tugas yang mengulang lalu menampilkan jumlah perulangan perulangan:

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, dan cara paling umum untuk memulai tugas di .NET Framework 4, adalah dengan memanggil metode TaskFactory.StartNew statis atau TaskFactory<TResult>.StartNew. Properti Task.Factory mengembalikan objek TaskFactory, dan properti Task<TResult>.Factory mengembalikan objek TaskFactory<TResult>. Kelebihan beban metode StartNew memungkinkan Anda meneruskan argumen, menentukan opsi pembuatan tugas, dan menentukan penjadwal tugas. Contoh berikut menggunakan metode TaskFactory<TResult>.StartNew(Func<TResult>) untuk memulai tugas. Ini secara fungsional setara dengan kode dalam contoh sebelumnya.

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

Untuk contoh lengkap lainnya, lihat Pemrograman Asinkron berbasis Tugas .

Kelas Task<TResult> juga menyediakan konstruktor yang menginisialisasi tugas tetapi tidak menjadwalkannya untuk eksekusi. Untuk alasan performa, metode Task.Run dan Task.Factory.StartNew adalah mekanisme pilihan untuk membuat dan menjadwalkan tugas komputasi, tetapi untuk skenario di mana pembuatan dan penjadwalan tugas harus dipisahkan, konstruktor dapat digunakan, dan metode Start tugas kemudian dapat digunakan untuk menjadwalkan tugas untuk eksekusi di lain waktu.

Dimulai dengan aplikasi desktop yang menargetkan .NET Framework 4.6, budaya utas yang membuat dan memanggil tugas menjadi bagian dari konteks utas. Artinya, terlepas dari budaya utas saat ini di mana tugas dijalankan, budaya tugas saat ini adalah budaya utas panggilan. Untuk aplikasi yang menargetkan versi .NET Framework sebelum .NET Framework 4.6, budaya tugas adalah budaya utas tempat tugas dijalankan. Untuk informasi selengkapnya, lihat bagian "Budaya dan operasi asinkron berbasis tugas" di topik CultureInfo. Perhatikan bahwa aplikasi Store mengikuti Windows Runtime dalam pengaturan dan mendapatkan budaya default.

Untuk operasi yang tidak mengembalikan nilai, Anda menggunakan kelas Task. Dimulai dengan C# 7.0, untuk tugas yang lebih ringan yang merupakan jenis nilai daripada jenis referensi, gunakan struktur System.Threading.Tasks.ValueTask<TResult>.

Konstruktor

Task<TResult>(Func<Object,TResult>, Object)	Menginisialisasi Task<TResult> baru dengan fungsi dan status yang ditentukan.
Task<TResult>(Func<Object,TResult>, Object, CancellationToken)	Menginisialisasi Task<TResult> baru dengan tindakan, status, dan opsi yang ditentukan.
Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)	Menginisialisasi Task<TResult> baru dengan tindakan, status, dan opsi yang ditentukan.
Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)	Menginisialisasi Task<TResult> baru dengan tindakan, status, dan opsi yang ditentukan.
Task<TResult>(Func<TResult>)	Menginisialisasi Task<TResult> baru dengan fungsi yang ditentukan.
Task<TResult>(Func<TResult>, CancellationToken)	Menginisialisasi Task<TResult> baru dengan fungsi yang ditentukan.
Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)	Menginisialisasi Task<TResult> baru dengan fungsi dan opsi pembuatan yang ditentukan.
Task<TResult>(Func<TResult>, TaskCreationOptions)	Menginisialisasi Task<TResult> baru dengan fungsi dan opsi pembuatan yang ditentukan.

Properti

AsyncState	Mendapatkan objek status yang disediakan ketika Task dibuat, atau null jika tidak ada yang disediakan. (Diperoleh dari Task)
CreationOptions	Mendapatkan TaskCreationOptions digunakan untuk membuat tugas ini. (Diperoleh dari Task)
Exception	Mendapatkan AggregateException yang menyebabkan Task berakhir sebelum waktunya. Jika Task berhasil diselesaikan atau belum memberikan pengecualian apa pun, ini akan mengembalikan null. (Diperoleh dari Task)
Factory	Mendapatkan metode pabrik untuk membuat dan mengonfigurasi instans Task<TResult>.
Id	Mendapatkan ID untuk instans Task ini. (Diperoleh dari Task)
IsCanceled	Mendapatkan apakah instans Task ini telah menyelesaikan eksekusi karena dibatalkan. (Diperoleh dari Task)
IsCompleted	Mendapatkan nilai yang menunjukkan apakah tugas telah selesai. (Diperoleh dari Task)
IsCompletedSuccessfully	Mendapatkan apakah tugas berjalan hingga selesai. (Diperoleh dari Task)
IsFaulted	Mendapatkan apakah Task selesai karena pengecualian yang tidak tertangani. (Diperoleh dari Task)
Result	Mendapatkan nilai hasil dari Task<TResult>ini.
Status	Mendapatkan TaskStatus tugas ini. (Diperoleh dari Task)

Metode

ConfigureAwait(Boolean)	Mengonfigurasi awaiter yang digunakan untuk menunggu Task<TResult>ini.
ConfigureAwait(ConfigureAwaitOptions)	Mengonfigurasi awaiter yang digunakan untuk menunggu Taskini.
ContinueWith(Action<Task,Object>, Object)	Membuat kelanjutan yang menerima informasi status yang disediakan penelepon dan dijalankan saat target Task selesai. (Diperoleh dari Task)
ContinueWith(Action<Task,Object>, Object, CancellationToken)	Membuat kelanjutan yang menerima informasi status yang disediakan penelepon dan token pembatalan dan yang dijalankan secara asinkron ketika target Task selesai. (Diperoleh dari Task)
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang menerima informasi status yang disediakan penelepon dan token pembatalan dan yang dijalankan saat target Task selesai. Kelanjutan dijalankan berdasarkan serangkaian kondisi yang ditentukan dan menggunakan penjadwal tertentu. (Diperoleh dari Task)
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)	Membuat kelanjutan yang menerima informasi status yang disediakan penelepon dan dijalankan saat target Task selesai. Kelanjutan dijalankan berdasarkan serangkaian kondisi yang ditentukan. (Diperoleh dari Task)
ContinueWith(Action<Task,Object>, Object, TaskScheduler)	Membuat kelanjutan yang menerima informasi status yang disediakan penelepon dan menjalankan secara asinkron ketika target Task selesai. Kelanjutan menggunakan penjadwal tertentu. (Diperoleh dari Task)
ContinueWith(Action<Task<TResult>,Object>, Object)	Membuat kelanjutan yang diteruskan informasi status dan yang dijalankan ketika target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>>)	Membuat kelanjutan yang dijalankan secara asinkron ketika tugas target selesai.
ContinueWith(Action<Task<TResult>>, CancellationToken)	Membuat kelanjutan yang dapat dibatalkan yang dijalankan secara asinkron ketika target Task<TResult> selesai.
ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.
ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.
ContinueWith(Action<Task<TResult>>, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task<TResult> selesai.
ContinueWith(Action<Task>)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai. (Diperoleh dari Task)
ContinueWith(Action<Task>, CancellationToken)	Membuat kelanjutan yang menerima token pembatalan dan dijalankan secara asinkron ketika target Task selesai. (Diperoleh dari Task)
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan ketika tugas target bersaing sesuai dengan TaskContinuationOptionsyang ditentukan. Kelanjutan menerima token pembatalan dan menggunakan penjadwal tertentu. (Diperoleh dari Task)
ContinueWith(Action<Task>, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan ketika tugas target selesai sesuai dengan TaskContinuationOptionsyang ditentukan. (Diperoleh dari Task)
ContinueWith(Action<Task>, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai. Kelanjutan menggunakan penjadwal tertentu. (Diperoleh dari Task)
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)	Membuat kelanjutan yang dijalankan saat target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task<TResult> selesai.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan sesuai dengan kondisi yang ditentukan dalam continuationOptions.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task<TResult> selesai.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)	Membuat kelanjutan yang menerima informasi status yang disediakan penelepon dan menjalankan secara asinkron ketika target Task selesai dan mengembalikan nilai. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai dan mengembalikan nilai. Kelanjutan menerima informasi status yang disediakan penelepon dan token pembatalan. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan berdasarkan opsi kelanjutan tugas yang ditentukan saat target Task selesai dan mengembalikan nilai. Kelanjutan menerima informasi status yang disediakan penelepon dan token pembatalan dan menggunakan penjadwal yang ditentukan. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan berdasarkan opsi kelanjutan tugas yang ditentukan saat target Task selesai. Kelanjutan menerima informasi status yang disediakan penelepon. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai. Kelanjutan menerima informasi status yang disediakan penelepon dan menggunakan penjadwal tertentu. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,TResult>)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task<TResult> selesai dan mengembalikan nilai. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai dan mengembalikan nilai. Kelanjutan menerima token pembatalan. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Membuat kelanjutan yang dijalankan sesuai dengan opsi kelanjutan yang ditentukan dan mengembalikan nilai. Kelanjutan diteruskan token pembatalan dan menggunakan penjadwal tertentu. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan sesuai dengan opsi kelanjutan yang ditentukan dan mengembalikan nilai. (Diperoleh dari Task)
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai dan mengembalikan nilai. Kelanjutan menggunakan penjadwal tertentu. (Diperoleh dari Task)
Dispose()	Merilis semua sumber daya yang digunakan oleh instans kelas Task saat ini. (Diperoleh dari Task)
Dispose(Boolean)	Membuang Task, melepaskan semua sumber dayanya yang tidak dikelola. (Diperoleh dari Task)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetAwaiter()	Mendapatkan penanam yang digunakan untuk menunggu Task<TResult>ini.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
RunSynchronously()	Menjalankan Task secara sinkron pada TaskSchedulersaat ini. (Diperoleh dari Task)
RunSynchronously(TaskScheduler)	Menjalankan Task secara sinkron pada TaskScheduler yang disediakan. (Diperoleh dari Task)
Start()	Memulai Task, menjadwalkannya untuk dieksekusi ke TaskSchedulersaat ini . (Diperoleh dari Task)
Start(TaskScheduler)	Memulai Task, menjadwalkannya untuk dieksekusi ke TaskScheduleryang ditentukan . (Diperoleh dari Task)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Wait()	Menunggu Task menyelesaikan eksekusi. (Diperoleh dari Task)
Wait(CancellationToken)	Menunggu Task menyelesaikan eksekusi. Tunggu berakhir jika token pembatalan dibatalkan sebelum tugas selesai. (Diperoleh dari Task)
Wait(Int32)	Menunggu Task menyelesaikan eksekusi dalam jumlah milidetik tertentu. (Diperoleh dari Task)
Wait(Int32, CancellationToken)	Menunggu Task menyelesaikan eksekusi. Tunggu berakhir jika interval batas waktu berlalu atau token pembatalan dibatalkan sebelum tugas selesai. (Diperoleh dari Task)
Wait(TimeSpan)	Menunggu Task menyelesaikan eksekusi dalam interval waktu tertentu. (Diperoleh dari Task)
Wait(TimeSpan, CancellationToken)	Menunggu Task menyelesaikan eksekusi. (Diperoleh dari Task)
WaitAsync(CancellationToken)	Mendapatkan Task<TResult> yang akan selesai ketika Task<TResult> ini selesai atau ketika CancellationToken yang ditentukan meminta pembatalan.
WaitAsync(TimeSpan)	Mendapatkan Task<TResult> yang akan selesai ketika Task<TResult> ini selesai atau ketika batas waktu yang ditentukan kedaluwarsa.
WaitAsync(TimeSpan, CancellationToken)	Mendapatkan Task<TResult> yang akan selesai ketika Task<TResult> ini selesai, ketika batas waktu yang ditentukan kedaluwarsa, atau ketika CancellationToken yang ditentukan memiliki pembatalan yang diminta.
WaitAsync(TimeSpan, TimeProvider)	Mendapatkan Task<TResult> yang akan selesai ketika Task<TResult> ini selesai atau ketika batas waktu yang ditentukan kedaluwarsa.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Mendapatkan Task<TResult> yang akan selesai ketika Task<TResult> ini selesai, ketika batas waktu yang ditentukan kedaluwarsa, atau ketika CancellationToken yang ditentukan memiliki pembatalan yang diminta.

Implementasi Antarmuka Eksplisit

IAsyncResult.AsyncWaitHandle	Mendapatkan WaitHandle yang dapat digunakan untuk menunggu tugas selesai. (Diperoleh dari Task)
IAsyncResult.CompletedSynchronously	Mendapatkan indikasi apakah operasi selesai secara sinkron. (Diperoleh dari Task)

Metode Ekstensi

WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken)	Mendapatkan Task yang akan selesai ketika Task ini selesai, ketika batas waktu yang ditentukan kedaluwarsa, atau ketika CancellationToken yang ditentukan memiliki pembatalan yang diminta.
WaitAsync<TResult>(Task<TResult>, TimeSpan, TimeProvider, CancellationToken)	Mendapatkan Task yang akan selesai ketika Task ini selesai, ketika batas waktu yang ditentukan kedaluwarsa, atau ketika CancellationToken yang ditentukan memiliki pembatalan yang diminta.

Keamanan Thread

Semua anggota Task<TResult>, kecuali Dispose(), aman utas dan dapat digunakan dari beberapa utas secara bersamaan.

Lihat juga

• Task
• Pustaka Paralel Tugas (TPL)
• Pemrograman Asinkron Berbasis Tugas
• Sampel untuk Pemrograman Paralel dengan .NET Core dan .NET Standard