SqlBulkCopy.WriteToServerAsync Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Versi asinkron , WriteToServeryang menyalin semua baris dari sumber data ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek .

Overload

WriteToServerAsync(IDataReader, CancellationToken)	Versi asinkron , WriteToServer(IDataReader)yang menyalin semua baris dalam yang disediakan IDataReader ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek . Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
WriteToServerAsync(DbDataReader)	Versi asinkron , WriteToServer(DbDataReader)yang menyalin semua baris dari array yang disediakan DbDataReader ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.
WriteToServerAsync(DataRow[])	Versi asinkron , WriteToServer(DataRow[])yang menyalin semua baris dari array yang disediakan DataRow ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.
WriteToServerAsync(DataTable)	Versi asinkron , WriteToServer(DataTable)yang menyalin semua baris dalam yang disediakan DataTable ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek .
WriteToServerAsync(IDataReader)	Versi asinkron , WriteToServer(IDataReader)yang menyalin semua baris dalam yang disediakan IDataReader ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek .
WriteToServerAsync(DbDataReader, CancellationToken)	Versi asinkron , WriteToServer(DbDataReader)yang menyalin semua baris dari array yang disediakan DbDataReader ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.
WriteToServerAsync(DataRow[], CancellationToken)	Versi asinkron , WriteToServer(DataRow[])yang menyalin semua baris dari array yang disediakan DataRow ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek. Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
WriteToServerAsync(DataTable, DataRowState)	Versi asinkron , WriteToServer(DataTable, DataRowState)yang hanya menyalin baris yang cocok dengan status baris yang disediakan dalam DataTable tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.
WriteToServerAsync(DataTable, CancellationToken)	Versi asinkron , WriteToServer(DataTable)yang menyalin semua baris dalam yang disediakan DataTable ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek . Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	Versi asinkron , WriteToServer(DataTable, DataRowState)yang hanya menyalin baris yang cocok dengan status baris yang disediakan dalam DataTable tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek. Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

Keterangan

Jika beberapa kumpulan hasil aktif (MARS) dinonaktifkan, WriteToServer membuat koneksi sibuk. Jika MARS diaktifkan, Anda dapat menyela panggilan ke WriteToServer dengan perintah lain dalam koneksi yang sama.

Jumlah baris yang digulung balik ketika satu gagal tergantung pada beberapa hal:

• Jika UseInternalTransaction ditentukan.

• Jika Anda memiliki transaksi Anda sendiri.

• Nilai dari BatchSize.

Ketika ada kesalahan saat mengirim data ke server, batch saat ini (seperti yang ditentukan oleh BatchSize) akan digulung balik. Jika UseInternalTransaction tidak ditentukan dan Anda memiliki transaksi Anda sendiri, seluruh transaksi akan digulung balik (yang mencakup semua batch sebelumnya juga).

Gunakan SqlRowsCopied untuk mengetahui berapa banyak baris yang disalin ke server.

WriteToServerAsync(IDataReader, CancellationToken)

Versi asinkron , WriteToServer(IDataReader)yang menyalin semua baris dalam yang disediakan IDataReader ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek .

Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::IDataReader ^ reader, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.IDataReader reader, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.IDataReader * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As Task

Parameter

reader

IDataReader

Baris IDataReader yang akan disalin ke tabel tujuan.

cancellationToken

CancellationToken

Instruksi pembatalan. Nilai None dalam parameter ini membuat metode ini setara dengan WriteToServerAsync(DataTable).

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil WriteToServerAsync(IDataReader) beberapa kali untuk instans yang sama sebelum penyelesaian tugas.

Memanggil WriteToServerAsync(IDataReader) dan WriteToServer(IDataReader) untuk instans yang sama sebelum penyelesaian tugas.

Koneksi terputus atau ditutup selama WriteToServerAsync(IDataReader) eksekusi.

Dikembalikan dalam objek tugas, SqlBulkCopy objek ditutup selama eksekusi metode.

Dikembalikan dalam objek tugas, ada batas waktu kumpulan koneksi.

Dikembalikan dalam objek tugas, SqlConnection objek ditutup sebelum eksekusi metode.

IDataReader ditutup sebelum selesai Task dikembalikan.

Koneksi IDataReaderterkait ditutup sebelum selesai Task dikembalikan.

Context Connection=trueditentukan dalam string koneksi.

SqlException

Dikembalikan dalam objek tugas, kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader)

Versi asinkron , WriteToServer(DbDataReader)yang menyalin semua baris dari array yang disediakan DbDataReader ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::Common::DbDataReader ^ reader);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.Common.DbDataReader reader);

member this.WriteToServerAsync : System.Data.Common.DbDataReader -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As DbDataReader) As Task

Parameter

reader

DbDataReader

Baris DbDataReader yang akan disalin ke tabel tujuan.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(DbDataReader).

WriteToServerAsync(DataRow[])

Versi asinkron , WriteToServer(DataRow[])yang menyalin semua baris dari array yang disediakan DataRow ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataRow[] rows);

member this.WriteToServerAsync : System.Data.DataRow[] -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (rows As DataRow()) As Task

Parameter

rows

DataRow[]

Array DataRow objek yang akan disalin ke tabel tujuan.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil WriteToServerAsync(DataRow[]) beberapa kali untuk instans yang sama sebelum penyelesaian tugas.

Memanggil WriteToServerAsync(DataRow[]) dan WriteToServer(DataRow[]) untuk instans yang sama sebelum penyelesaian tugas.

Koneksi terputus atau ditutup selama WriteToServerAsync(DataRow[]) eksekusi.

Dikembalikan dalam objek tugas, SqlBulkCopy objek ditutup selama eksekusi metode.

Dikembalikan dalam objek tugas, ada batas waktu kumpulan koneksi.

Dikembalikan dalam objek tugas, SqlConnection objek ditutup sebelum eksekusi metode.

Context Connection=trueditentukan dalam string koneksi.

SqlException

Dikembalikan dalam objek tugas, kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(DataRow[]).

WriteToServerAsync(DataTable)

Versi asinkron , WriteToServer(DataTable)yang menyalin semua baris dalam yang disediakan DataTable ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek .

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table);

member this.WriteToServerAsync : System.Data.DataTable -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable) As Task

Parameter

table

DataTable

Baris DataTable yang akan disalin ke tabel tujuan.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil WriteToServerAsync(DataTable) beberapa kali untuk instans yang sama sebelum penyelesaian tugas.

Memanggil WriteToServerAsync(DataTable) dan WriteToServer(DataTable) untuk instans yang sama sebelum penyelesaian tugas.

Koneksi terputus atau ditutup selama WriteToServerAsync(DataTable) eksekusi.

Dikembalikan dalam objek tugas, SqlBulkCopy objek ditutup selama eksekusi metode.

Dikembalikan dalam objek tugas, ada batas waktu kumpulan koneksi.

Dikembalikan dalam objek tugas, SqlConnection objek ditutup sebelum eksekusi metode.

Context Connection=trueditentukan dalam string koneksi.

SqlException

Dikembalikan dalam objek tugas, kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(DataTable).

WriteToServerAsync(IDataReader)

Versi asinkron , WriteToServer(IDataReader)yang menyalin semua baris dalam yang disediakan IDataReader ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek .

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::IDataReader ^ reader);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.IDataReader reader);

member this.WriteToServerAsync : System.Data.IDataReader -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As IDataReader) As Task

Parameter

reader

IDataReader

Baris IDataReader yang akan disalin ke tabel tujuan.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil WriteToServerAsync(IDataReader) beberapa kali untuk instans yang sama sebelum penyelesaian tugas.

Memanggil WriteToServerAsync(IDataReader) dan WriteToServer(IDataReader) untuk instans yang sama sebelum penyelesaian tugas.

Koneksi terputus atau ditutup selama WriteToServerAsync(IDataReader) eksekusi.

Dikembalikan dalam objek tugas, SqlBulkCopy objek ditutup selama eksekusi metode.

Dikembalikan dalam objek tugas, ada batas waktu kumpulan koneksi.

Dikembalikan dalam objek tugas, SqlConnection objek ditutup sebelum eksekusi metode.

IDataReader ditutup sebelum selesai Task dikembalikan.

Koneksi IDataReaderterkait ditutup sebelum selesai Task dikembalikan.

Context Connection=trueditentukan dalam string koneksi.

SqlException

Dikembalikan dalam objek tugas, kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader, CancellationToken)

Versi asinkron , WriteToServer(DbDataReader)yang menyalin semua baris dari array yang disediakan DbDataReader ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::Common::DbDataReader ^ reader, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.Common.DbDataReader reader, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.Common.DbDataReader * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As Task

Parameter

reader

DbDataReader

Baris DbDataReader yang akan disalin ke tabel tujuan.

cancellationToken

CancellationToken

Instruksi pembatalan. Nilai None dalam parameter ini membuat metode ini setara dengan WriteToServerAsync(DbDataReader).

Mengembalikan

Task

Menampilkan Task.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

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 WriteToServer(DbDataReader).

WriteToServerAsync(DataRow[], CancellationToken)

Versi asinkron , WriteToServer(DataRow[])yang menyalin semua baris dari array yang disediakan DataRow ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.

Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataRow[] rows, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataRow[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As Task

Parameter

rows

DataRow[]

Array DataRow objek yang akan disalin ke tabel tujuan.

cancellationToken

CancellationToken

Instruksi pembatalan. Nilai None dalam parameter ini membuat metode ini setara dengan WriteToServerAsync(DataTable).

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil WriteToServerAsync(DataRow[]) beberapa kali untuk instans yang sama sebelum penyelesaian tugas.

Memanggil WriteToServerAsync(DataRow[]) dan WriteToServer(DataRow[]) untuk instans yang sama sebelum penyelesaian tugas.

Koneksi terputus atau ditutup selama WriteToServerAsync(DataRow[]) eksekusi.

Dikembalikan dalam objek tugas, SqlBulkCopy objek ditutup selama eksekusi metode.

Dikembalikan dalam objek tugas, ada batas waktu kumpulan koneksi.

Dikembalikan dalam objek tugas, SqlConnection objek ditutup sebelum eksekusi metode.

Context Connection=trueditentukan dalam string koneksi.

SqlException

Dikembalikan dalam objek tugas, kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(DataRow[]).

WriteToServerAsync(DataTable, DataRowState)

Versi asinkron , WriteToServer(DataTable, DataRowState)yang hanya menyalin baris yang cocok dengan status baris yang disediakan dalam DataTable tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Data::DataRowState rowState);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Data.DataRowState rowState);

member this.WriteToServerAsync : System.Data.DataTable * System.Data.DataRowState -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As Task

Parameter

table

DataTable

Baris DataTable yang akan disalin ke tabel tujuan.

rowState

DataRowState

Nilai dari DataRowState enumerasi. Hanya baris yang cocok dengan status baris yang disalin ke tujuan.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil WriteToServerAsync(DataTable, DataRowState) beberapa kali untuk instans yang sama sebelum penyelesaian tugas.

Memanggil WriteToServerAsync(DataTable, DataRowState) dan WriteToServer(DataTable, DataRowState) untuk instans yang sama sebelum penyelesaian tugas.

Koneksi terputus atau ditutup selama WriteToServerAsync(DataTable, DataRowState) eksekusi.

Dikembalikan dalam objek tugas, SqlBulkCopy objek ditutup selama eksekusi metode.

Dikembalikan dalam objek tugas, ada batas waktu kumpulan koneksi.

Dikembalikan dalam objek tugas, SqlConnection objek ditutup sebelum eksekusi metode.

Context Connection=trueditentukan dalam string koneksi.

SqlException

Dikembalikan dalam objek tugas, kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(DataTable, DataRowState).

WriteToServerAsync(DataTable, CancellationToken)

Versi asinkron , WriteToServer(DataTable)yang menyalin semua baris dalam yang disediakan DataTable ke tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek .

Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataTable * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As Task

Parameter

table

DataTable

Baris DataTable yang akan disalin ke tabel tujuan.

cancellationToken

CancellationToken

Instruksi pembatalan. Nilai None dalam parameter ini membuat metode ini setara dengan WriteToServerAsync(DataTable).

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil WriteToServerAsync(DataTable) beberapa kali untuk instans yang sama sebelum penyelesaian tugas.

Memanggil WriteToServerAsync(DataTable) dan WriteToServer(DataTable) untuk instans yang sama sebelum penyelesaian tugas.

Koneksi terputus atau ditutup selama WriteToServerAsync(DataTable) eksekusi.

Dikembalikan dalam objek tugas, SqlBulkCopy objek ditutup selama eksekusi metode.

Dikembalikan dalam objek tugas, ada batas waktu kumpulan koneksi.

Dikembalikan dalam objek tugas, SqlConnection objek ditutup sebelum eksekusi metode.

Context Connection=trueditentukan dalam string koneksi.

SqlException

Dikembalikan dalam objek tugas, kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(DataTable).

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Versi asinkron , WriteToServer(DataTable, DataRowState)yang hanya menyalin baris yang cocok dengan status baris yang disediakan dalam DataTable tabel tujuan yang ditentukan oleh DestinationTableName properti SqlBulkCopy objek.

Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Data::DataRowState rowState, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Data.DataRowState rowState, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataTable * System.Data.DataRowState * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As Task

Parameter

table

DataTable

Baris DataTable yang akan disalin ke tabel tujuan.

rowState

DataRowState

Nilai dari DataRowState enumerasi. Hanya baris yang cocok dengan status baris yang disalin ke tujuan.

cancellationToken

CancellationToken

Instruksi pembatalan. Nilai None dalam parameter ini membuat metode ini setara dengan WriteToServerAsync(DataTable).

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil WriteToServerAsync(DataTable, DataRowState) beberapa kali untuk instans yang sama sebelum penyelesaian tugas.

Memanggil WriteToServerAsync(DataTable, DataRowState) dan WriteToServer(DataTable, DataRowState) untuk instans yang sama sebelum penyelesaian tugas.

Koneksi terputus atau ditutup selama WriteToServerAsync(DataTable, DataRowState) eksekusi.

Dikembalikan dalam objek tugas, SqlBulkCopy objek ditutup selama eksekusi metode.

Dikembalikan dalam objek tugas, ada batas waktu kumpulan koneksi.

Dikembalikan dalam objek tugas, SqlConnection objek ditutup sebelum eksekusi metode.

Context Connection=trueditentukan dalam string koneksi.

SqlException

Dikembalikan dalam objek tugas, kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

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 WriteToServer(DataTable, DataRowState).