TaskToAsyncResult.Begin(Task, AsyncCallback, Object) Metode

Definisi

Ruang nama:

System.Threading.Tasks

Rakitan:

System.Runtime.dll

Sumber:

TaskToAsyncResult.cs

Membuat baru IAsyncResult dari yang ditentukan Task, secara opsional memanggil callback ketika tugas telah selesai.

public:
 static IAsyncResult ^ Begin(System::Threading::Tasks::Task ^ task, AsyncCallback ^ callback, System::Object ^ state);

public static IAsyncResult Begin (System.Threading.Tasks.Task task, AsyncCallback? callback, object? state);

static member Begin : System.Threading.Tasks.Task * AsyncCallback * obj -> IAsyncResult

Public Shared Function Begin (task As Task, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

task

Task

yang Task akan dibungkus dalam IAsyncResult.

callback

AsyncCallback

Panggilan balik yang akan dipanggil setelah taskselesai. Jika null, tidak ada panggilan balik yang akan dipanggil.

state

Object

Status yang akan disimpan di IAsyncResult.

Mengembalikan

IAsyncResult

IAsyncResult untuk mewakili operasi asinkron tugas. Instans ini juga akan diteruskan ke callback saat dipanggil.

Pengecualian

ArgumentNullException

taskadalah null.

Keterangan

Bersama dengan End(IAsyncResult) metode atau End<TResult>(IAsyncResult) , metode ini dapat digunakan untuk mengimplementasikan pola Begin/End (juga dikenal sebagai pola Model Pemrograman Asinkron, atau APM). Disarankan untuk tidak mengekspos pola ini dalam kode baru; metode pada TaskToAsyncResult dimaksudkan hanya untuk membantu menerapkan metode Begin/End seperti itu ketika harus diekspos, misalnya karena kelas dasar menyediakan metode virtual untuk pola, atau ketika mereka telah terekspos dan harus tetap untuk kompatibilitas. Metode ini memungkinkan penerapan semua logika asinkron inti melalui Tasks dan kemudian dengan mudah menerapkan metode Begin/End di sekitar fungsionalitas tersebut.