Task Kelas

Definisi

Ruang nama:

System.Threading.Tasks

Rakitan:

System.Runtime.dll

Sumber:

Task.cs

Mewakili operasi asinkron.

public ref class Task : IAsyncResult, IDisposable

public class Task : IAsyncResult, IDisposable

type Task = class
    interface IAsyncResult
    interface IDisposable

Public Class Task
Implements IAsyncResult, IDisposable

Warisan

Object

Task

Turunan

System.Threading.Tasks.Task<TResult>

Penerapan

IAsyncResult IDisposable

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat keterangan API Tambahan untuk Task.

Konstruktor

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

Properti

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

Metode

ConfigureAwait(Boolean)	Mengonfigurasi awaiter yang digunakan untuk menunggu Taskini.
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.
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.
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.
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.
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.
ContinueWith(Action<Task>)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai.
ContinueWith(Action<Task>, CancellationToken)	Membuat kelanjutan yang menerima token pembatalan dan dijalankan secara asinkron ketika target Task selesai.
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.
ContinueWith(Action<Task>, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan ketika tugas target selesai sesuai dengan TaskContinuationOptionsyang ditentukan.
ContinueWith(Action<Task>, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai. Kelanjutan menggunakan penjadwal tertentu.
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.
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.
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.
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.
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.
ContinueWith<TResult>(Func<Task,TResult>)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task<TResult> selesai dan mengembalikan nilai.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai dan mengembalikan nilai. Kelanjutan menerima token pembatalan.
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.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)	Membuat kelanjutan yang dijalankan sesuai dengan opsi kelanjutan yang ditentukan dan mengembalikan nilai.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)	Membuat kelanjutan yang dijalankan secara asinkron ketika target Task selesai dan mengembalikan nilai. Kelanjutan menggunakan penjadwal tertentu.
Delay(Int32)	Membuat tugas yang selesai setelah jumlah milidetik tertentu.
Delay(Int32, CancellationToken)	Membuat tugas yang dapat dibatalkan yang selesai setelah jumlah milidetik tertentu.
Delay(TimeSpan)	Membuat tugas yang selesai setelah interval waktu tertentu.
Delay(TimeSpan, CancellationToken)	Membuat tugas yang dapat dibatalkan yang selesai setelah interval waktu tertentu.
Delay(TimeSpan, TimeProvider)	Membuat tugas yang selesai setelah interval waktu tertentu.
Delay(TimeSpan, TimeProvider, CancellationToken)	Membuat tugas yang dapat dibatalkan yang selesai setelah interval waktu tertentu.
Dispose()	Merilis semua sumber daya yang digunakan oleh instans kelas Task saat ini.
Dispose(Boolean)	Membuang Task, melepaskan semua sumber dayanya yang tidak dikelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FromCanceled(CancellationToken)	Membuat Task yang selesai karena pembatalan dengan token pembatalan tertentu.
FromCanceled<TResult>(CancellationToken)	Membuat Task<TResult> yang selesai karena pembatalan dengan token pembatalan tertentu.
FromException(Exception)	Membuat Task yang telah selesai dengan pengecualian tertentu.
FromException<TResult>(Exception)	Membuat Task<TResult> yang selesai dengan pengecualian tertentu.
FromResult<TResult>(TResult)	Membuat Task<TResult> yang berhasil diselesaikan dengan hasil yang ditentukan.
GetAwaiter()	Mendapatkan penanam yang digunakan untuk menunggu Taskini.
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)
Run(Action)	Mengantrekan pekerjaan yang ditentukan untuk dijalankan pada kumpulan utas dan mengembalikan objek Task yang mewakili pekerjaan tersebut.
Run(Action, CancellationToken)	Mengantrekan pekerjaan yang ditentukan untuk dijalankan pada kumpulan utas dan mengembalikan objek Task yang mewakili pekerjaan tersebut. Token pembatalan memungkinkan pekerjaan dibatalkan jika belum dimulai.
Run(Func<Task>)	Mengantrekan pekerjaan yang ditentukan untuk dijalankan pada kumpulan utas dan mengembalikan proksi untuk tugas yang dikembalikan oleh function.
Run(Func<Task>, CancellationToken)	Mengantrekan pekerjaan yang ditentukan untuk dijalankan pada kumpulan utas dan mengembalikan proksi untuk tugas yang dikembalikan oleh function. Token pembatalan memungkinkan pekerjaan dibatalkan jika belum dimulai.
Run<TResult>(Func<Task<TResult>>)	Mengantrekan pekerjaan yang ditentukan untuk dijalankan pada kumpulan utas dan mengembalikan proksi untuk Task(TResult) yang dikembalikan oleh function. Token pembatalan memungkinkan pekerjaan dibatalkan jika belum dimulai.
Run<TResult>(Func<Task<TResult>>, CancellationToken)	Mengantrekan pekerjaan yang ditentukan untuk dijalankan pada kumpulan utas dan mengembalikan proksi untuk Task(TResult) yang dikembalikan oleh function.
Run<TResult>(Func<TResult>)	Mengantrekan pekerjaan yang ditentukan untuk dijalankan pada kumpulan utas dan mengembalikan objek Task<TResult> yang mewakili pekerjaan tersebut. Token pembatalan memungkinkan pekerjaan dibatalkan jika belum dimulai.
Run<TResult>(Func<TResult>, CancellationToken)	Mengantrekan pekerjaan yang ditentukan untuk dijalankan pada kumpulan utas dan mengembalikan objek Task(TResult) yang mewakili pekerjaan tersebut.
RunSynchronously()	Menjalankan Task secara sinkron pada TaskSchedulersaat ini.
RunSynchronously(TaskScheduler)	Menjalankan Task secara sinkron pada TaskScheduler yang disediakan.
Start()	Memulai Task, menjadwalkannya untuk dieksekusi ke TaskSchedulersaat ini .
Start(TaskScheduler)	Memulai Task, menjadwalkannya untuk dieksekusi ke TaskScheduleryang ditentukan .
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Wait()	Menunggu Task menyelesaikan eksekusi.
Wait(CancellationToken)	Menunggu Task menyelesaikan eksekusi. Tunggu berakhir jika token pembatalan dibatalkan sebelum tugas selesai.
Wait(Int32)	Menunggu Task menyelesaikan eksekusi dalam jumlah milidetik tertentu.
Wait(Int32, CancellationToken)	Menunggu Task menyelesaikan eksekusi. Tunggu berakhir jika interval batas waktu berlalu atau token pembatalan dibatalkan sebelum tugas selesai.
Wait(TimeSpan)	Menunggu Task menyelesaikan eksekusi dalam interval waktu tertentu.
Wait(TimeSpan, CancellationToken)	Menunggu Task menyelesaikan eksekusi.
WaitAll(Task[])	Menunggu semua objek Task yang disediakan untuk menyelesaikan eksekusi.
WaitAll(Task[], CancellationToken)	Menunggu semua objek Task yang disediakan untuk menyelesaikan eksekusi kecuali tunggu dibatalkan.
WaitAll(Task[], Int32)	Menunggu semua objek Task yang disediakan untuk menyelesaikan eksekusi dalam jumlah milidetik tertentu.
WaitAll(Task[], Int32, CancellationToken)	Menunggu semua objek Task yang disediakan untuk menyelesaikan eksekusi dalam jumlah milidetik tertentu atau hingga penantian dibatalkan.
WaitAll(Task[], TimeSpan)	Menunggu semua objek Task yang dapat dibatalkan yang disediakan untuk menyelesaikan eksekusi dalam interval waktu tertentu.
WaitAny(Task[])	Menunggu salah satu objek Task yang disediakan untuk menyelesaikan eksekusi.
WaitAny(Task[], CancellationToken)	Menunggu salah satu objek Task yang disediakan untuk menyelesaikan eksekusi kecuali tunggu dibatalkan.
WaitAny(Task[], Int32)	Menunggu salah satu objek Task yang disediakan untuk menyelesaikan eksekusi dalam jumlah milidetik tertentu.
WaitAny(Task[], Int32, CancellationToken)	Menunggu salah satu objek Task yang disediakan untuk menyelesaikan eksekusi dalam jumlah milidetik tertentu atau hingga token pembatalan dibatalkan.
WaitAny(Task[], TimeSpan)	Menunggu salah satu objek Task yang disediakan untuk menyelesaikan eksekusi dalam interval waktu yang ditentukan.
WaitAsync(CancellationToken)	Mendapatkan Task yang akan selesai ketika Task ini selesai atau ketika CancellationToken yang ditentukan meminta pembatalan.
WaitAsync(TimeSpan)	Mendapatkan Task yang akan selesai ketika Task ini selesai atau ketika batas waktu yang ditentukan kedaluwarsa.
WaitAsync(TimeSpan, 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(TimeSpan, TimeProvider)	Mendapatkan Task yang akan selesai ketika Task ini selesai atau ketika batas waktu yang ditentukan kedaluwarsa.
WaitAsync(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.
WhenAll(IEnumerable<Task>)	Membuat tugas yang akan selesai ketika semua objek Task dalam koleksi yang dapat dihitung telah selesai.
WhenAll(Task[])	Membuat tugas yang akan selesai ketika semua objek Task dalam array telah selesai.
WhenAll<TResult>(IEnumerable<Task<TResult>>)	Membuat tugas yang akan selesai ketika semua objek Task<TResult> dalam koleksi yang dapat dihitung telah selesai.
WhenAll<TResult>(Task<TResult>[])	Membuat tugas yang akan selesai ketika semua objek Task<TResult> dalam array telah selesai.
WhenAny(IEnumerable<Task>)	Membuat tugas yang akan selesai ketika salah satu tugas yang disediakan telah selesai.
WhenAny(Task, Task)	Membuat tugas yang akan selesai ketika salah satu tugas yang disediakan telah selesai.
WhenAny(Task[])	Membuat tugas yang akan selesai ketika salah satu tugas yang disediakan telah selesai.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Membuat tugas yang akan selesai ketika salah satu tugas yang disediakan telah selesai.
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Membuat tugas yang akan selesai ketika salah satu tugas yang disediakan telah selesai.
WhenAny<TResult>(Task<TResult>[])	Membuat tugas yang akan selesai ketika salah satu tugas yang disediakan telah selesai.
Yield()	Membuat tugas yang dapat ditunggu yang secara asinkron menghasilkan kembali ke konteks saat ini saat ditunggu.

Implementasi Antarmuka Eksplisit

IAsyncResult.AsyncWaitHandle	Mendapatkan WaitHandle yang dapat digunakan untuk menunggu tugas selesai.
IAsyncResult.CompletedSynchronously	Mendapatkan indikasi apakah operasi selesai secara sinkron.

Metode Ekstensi

AsyncWait<TException>(Task)	Mewakili operasi asinkron.
AwaitWithTimeout(Task, TimeSpan)	Mewakili operasi asinkron.
ToApm(Task, AsyncCallback, Object)	Mewakili operasi asinkron.
ToApmEnd(IAsyncResult)	Mewakili operasi asinkron.
ToApmEnd<TResult>(IAsyncResult)	Mewakili operasi asinkron.
Wait(Task, TimeSpan, Action<Exception,TimeSpan,String>, String)	Mewakili operasi asinkron.
WaitForCompletion(Task)	Mewakili operasi asinkron.
WaitForCompletionNoSpin(Task)	Mewakili operasi asinkron.
WaitForCompletionNoSpin(Task, TimeSpan)	Mewakili operasi asinkron.
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.

Keamanan Thread

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

Lihat juga

• Task<TResult>
• Pustaka Paralel Tugas (TPL)
• Pola asinkron berbasis tugas (TAP) di .NET: Pengenalan dan gambaran umum
• Pemrograman Asinkron Berbasis Tugas
• Sampel untuk Pemrograman Paralel dengan .NET Core dan .NET Standard