DbCommand.PrepareAsync(CancellationToken) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Secara asinkron membuat versi perintah yang disiapkan (atau dikompilasi) pada sumber data.
public virtual System.Threading.Tasks.Task PrepareAsync (System.Threading.CancellationToken cancellationToken = default);abstract member PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function PrepareAsync (Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- cancellationToken
- CancellationToken
Token opsional untuk membatalkan operasi asinkron. Nilai defaultnya adalah None.
Mengembalikan
mewakili Task operasi asinkron.
Pengecualian
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Implementasi default metode asinkron ini mendelegasikan ke rekan sinkronnya dan mengembalikan yang selesai Task, berpotensi memblokir utas panggilan.
Penyedia data yang mendukung pemrograman asinkron harus mengambil alih implementasi default menggunakan operasi I/O asinkron.
CommandType Jika properti diatur ke TableDirect, PrepareAsync tidak melakukan apa pun. Jika CommandType diatur ke StoredProcedure, panggilan ke PrepareAsync harus berhasil, meskipun dapat mengakibatkan no-op.
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Prepare().
