SqlBulkCopy.WriteToServerAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.SqlClient.dll

Pakiet:

System.Data.SqlClient v4.8.6

Asynchroniczna wersja WriteToServerprogramu , która kopiuje wszystkie wiersze ze źródła danych do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

Przeciążenia

WriteToServerAsync(IDataReader, CancellationToken)	Asynchroniczna wersja elementu WriteToServer(IDataReader), która kopiuje wszystkie wiersze podane IDataReader do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.
WriteToServerAsync(DbDataReader)	Asynchroniczna wersja klasy WriteToServer(DbDataReader), która kopiuje wszystkie wiersze z dostarczonej DbDataReader tablicy do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
WriteToServerAsync(DataRow[])	Asynchroniczna wersja klasy WriteToServer(DataRow[]), która kopiuje wszystkie wiersze z dostarczonej DataRow tablicy do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
WriteToServerAsync(DataTable)	Asynchroniczna wersja elementu WriteToServer(DataTable), która kopiuje wszystkie wiersze podane DataTable do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
WriteToServerAsync(IDataReader)	Asynchroniczna wersja elementu WriteToServer(IDataReader), która kopiuje wszystkie wiersze podane IDataReader do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
WriteToServerAsync(DbDataReader, CancellationToken)	Asynchroniczna wersja klasy WriteToServer(DbDataReader), która kopiuje wszystkie wiersze z dostarczonej DbDataReader tablicy do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
WriteToServerAsync(DataRow[], CancellationToken)	Asynchroniczna wersja klasy WriteToServer(DataRow[]), która kopiuje wszystkie wiersze z dostarczonej DataRow tablicy do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.
WriteToServerAsync(DataTable, DataRowState)	Wersja asynchroniczna programu WriteToServer(DataTable, DataRowState), która kopiuje tylko wiersze zgodne ze stanem podanego wiersza w podanej DataTable tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
WriteToServerAsync(DataTable, CancellationToken)	Asynchroniczna wersja elementu WriteToServer(DataTable), która kopiuje wszystkie wiersze podane DataTable do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	Wersja asynchroniczna programu WriteToServer(DataTable, DataRowState), która kopiuje tylko wiersze zgodne ze stanem podanego wiersza w podanej DataTable tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

Uwagi

Jeśli wiele aktywnych zestawów wyników (MARS) jest wyłączonych, WriteToServer połączenie jest zajęte. Jeśli usługa MARS jest włączona, można przeplatać wywołania z WriteToServer innymi poleceniami w tym samym połączeniu.

Liczba wierszy, które są wycofywane w przypadku awarii, zależy od kilku elementów:

• Jeśli UseInternalTransaction określono wartość .

• Jeśli masz własną transakcję.

• Wartość .BatchSize

Gdy wystąpi błąd podczas wysyłania danych do serwera, bieżąca partia (określona przez BatchSize) zostanie wycofana. Jeśli UseInternalTransaction nie zostanie określona i masz własną transakcję, cała transakcja zostanie wycofana (łącznie ze wszystkimi poprzednimi partiami).

Użyj polecenia SqlRowsCopied , aby dowiedzieć się, ile wierszy zostało skopiowanych do serwera.

WriteToServerAsync(IDataReader, CancellationToken)

Asynchroniczna wersja elementu WriteToServer(IDataReader), która kopiuje wszystkie wiersze podane IDataReader do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

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

Parametry

reader

IDataReader

A IDataReader którego wiersze zostaną skopiowane do tabeli docelowej.

cancellationToken

CancellationToken

Instrukcja anulowania. Wartość None w tym parametrze sprawia, że ta metoda jest równoważna WriteToServerAsync(DataTable).

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie WriteToServerAsync(IDataReader) wiele razy dla tego samego wystąpienia przed ukończeniem zadania.

Wywołanie WriteToServerAsync(IDataReader) i WriteToServer(IDataReader) dla tego samego wystąpienia przed ukończeniem zadania.

Połączenie spada lub jest zamykane podczas WriteToServerAsync(IDataReader) wykonywania.

Zwrócony w obiekcie SqlBulkCopy zadania obiekt został zamknięty podczas wykonywania metody.

Zwrócony w obiekcie zadania wystąpił limit czasu puli połączeń.

Zwrócony w obiekcie SqlConnection zadania obiekt jest zamknięty przed wykonaniem metody.

Element IDataReader został zamknięty przed zwróceniem ukończonego Task .

IDataReaderSkojarzone połączenie zostało zamknięte przed zwróceniem ukończonegoTask.

Context Connection=truejest określony w parametry połączenia.

SqlException

Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(IDataReader)usługę .

WriteToServerAsync(DbDataReader)

Asynchroniczna wersja klasy WriteToServer(DbDataReader), która kopiuje wszystkie wiersze z dostarczonej DbDataReader tablicy do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

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

Parametry

reader

DbDataReader

A DbDataReader którego wiersze zostaną skopiowane do tabeli docelowej.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(DbDataReader)usługę .

WriteToServerAsync(DataRow[])

Asynchroniczna wersja klasy WriteToServer(DataRow[]), która kopiuje wszystkie wiersze z dostarczonej DataRow tablicy do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

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

Parametry

rows

DataRow[]

Tablica DataRow obiektów, które zostaną skopiowane do tabeli docelowej.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie WriteToServerAsync(DataRow[]) wiele razy dla tego samego wystąpienia przed ukończeniem zadania.

Wywołanie WriteToServerAsync(DataRow[]) i WriteToServer(DataRow[]) dla tego samego wystąpienia przed ukończeniem zadania.

Połączenie spada lub jest zamykane podczas WriteToServerAsync(DataRow[]) wykonywania.

Zwrócony w obiekcie SqlBulkCopy zadania obiekt został zamknięty podczas wykonywania metody.

Zwrócony w obiekcie zadania wystąpił limit czasu puli połączeń.

Zwrócony w obiekcie SqlConnection zadania obiekt jest zamknięty przed wykonaniem metody.

Context Connection=truejest określony w parametry połączenia.

SqlException

Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(DataRow[])usługę .

WriteToServerAsync(DataTable)

Asynchroniczna wersja elementu WriteToServer(DataTable), która kopiuje wszystkie wiersze podane DataTable do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

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

Parametry

table

DataTable

A DataTable którego wiersze zostaną skopiowane do tabeli docelowej.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie WriteToServerAsync(DataTable) wiele razy dla tego samego wystąpienia przed ukończeniem zadania.

Wywołanie WriteToServerAsync(DataTable) i WriteToServer(DataTable) dla tego samego wystąpienia przed ukończeniem zadania.

Połączenie spada lub jest zamykane podczas WriteToServerAsync(DataTable) wykonywania.

Zwrócony w obiekcie SqlBulkCopy zadania obiekt został zamknięty podczas wykonywania metody.

Zwrócony w obiekcie zadania wystąpił limit czasu puli połączeń.

Zwrócony w obiekcie SqlConnection zadania obiekt jest zamknięty przed wykonaniem metody.

Context Connection=truejest określony w parametry połączenia.

SqlException

Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(DataTable)usługę .

WriteToServerAsync(IDataReader)

Asynchroniczna wersja elementu WriteToServer(IDataReader), która kopiuje wszystkie wiersze podane IDataReader do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

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

Parametry

reader

IDataReader

A IDataReader którego wiersze zostaną skopiowane do tabeli docelowej.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie WriteToServerAsync(IDataReader) wiele razy dla tego samego wystąpienia przed ukończeniem zadania.

Wywołanie WriteToServerAsync(IDataReader) i WriteToServer(IDataReader) dla tego samego wystąpienia przed ukończeniem zadania.

Połączenie spada lub jest zamykane podczas WriteToServerAsync(IDataReader) wykonywania.

Zwrócony w obiekcie SqlBulkCopy zadania obiekt został zamknięty podczas wykonywania metody.

Zwrócony w obiekcie zadania wystąpił limit czasu puli połączeń.

Zwrócony w obiekcie SqlConnection zadania obiekt jest zamknięty przed wykonaniem metody.

Element IDataReader został zamknięty przed zwróceniem ukończonego Task .

IDataReaderSkojarzone połączenie zostało zamknięte przed zwróceniem ukończonegoTask.

Context Connection=truejest określony w parametry połączenia.

SqlException

Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(IDataReader)usługę .

WriteToServerAsync(DbDataReader, CancellationToken)

Asynchroniczna wersja klasy WriteToServer(DbDataReader), która kopiuje wszystkie wiersze z dostarczonej DbDataReader tablicy do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

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

Parametry

reader

DbDataReader

A DbDataReader którego wiersze zostaną skopiowane do tabeli docelowej.

cancellationToken

CancellationToken

Instrukcja anulowania. Wartość None w tym parametrze sprawia, że ta metoda jest równoważna WriteToServerAsync(DbDataReader).

Zwraca

Task

Zwraca wartość Task.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(DbDataReader)usługę .

WriteToServerAsync(DataRow[], CancellationToken)

Asynchroniczna wersja klasy WriteToServer(DataRow[]), która kopiuje wszystkie wiersze z dostarczonej DataRow tablicy do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

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

Parametry

rows

DataRow[]

Tablica DataRow obiektów, które zostaną skopiowane do tabeli docelowej.

cancellationToken

CancellationToken

Instrukcja anulowania. Wartość None w tym parametrze sprawia, że ta metoda jest równoważna WriteToServerAsync(DataTable).

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie WriteToServerAsync(DataRow[]) wiele razy dla tego samego wystąpienia przed ukończeniem zadania.

Wywołanie WriteToServerAsync(DataRow[]) i WriteToServer(DataRow[]) dla tego samego wystąpienia przed ukończeniem zadania.

Połączenie spada lub jest zamykane podczas WriteToServerAsync(DataRow[]) wykonywania.

Zwrócony w obiekcie SqlBulkCopy zadania obiekt został zamknięty podczas wykonywania metody.

Zwrócony w obiekcie zadania wystąpił limit czasu puli połączeń.

Zwrócony w obiekcie SqlConnection zadania obiekt jest zamknięty przed wykonaniem metody.

Context Connection=truejest określony w parametry połączenia.

SqlException

Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(DataRow[])usługę .

WriteToServerAsync(DataTable, DataRowState)

Wersja asynchroniczna programu WriteToServer(DataTable, DataRowState), która kopiuje tylko wiersze zgodne ze stanem podanego wiersza w podanej DataTable tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

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

Parametry

table

DataTable

A DataTable którego wiersze zostaną skopiowane do tabeli docelowej.

rowState

DataRowState

Wartość z wyliczenia DataRowState . Do miejsca docelowego są kopiowane tylko wiersze pasujące do stanu wiersza.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie WriteToServerAsync(DataTable, DataRowState) wiele razy dla tego samego wystąpienia przed ukończeniem zadania.

Wywołanie WriteToServerAsync(DataTable, DataRowState) i WriteToServer(DataTable, DataRowState) dla tego samego wystąpienia przed ukończeniem zadania.

Połączenie spada lub jest zamykane podczas WriteToServerAsync(DataTable, DataRowState) wykonywania.

Zwrócony w obiekcie SqlBulkCopy zadania obiekt został zamknięty podczas wykonywania metody.

Zwrócony w obiekcie zadania wystąpił limit czasu puli połączeń.

Zwrócony w obiekcie SqlConnection zadania obiekt jest zamknięty przed wykonaniem metody.

Context Connection=truejest określony w parametry połączenia.

SqlException

Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(DataTable, DataRowState)usługę .

WriteToServerAsync(DataTable, CancellationToken)

Asynchroniczna wersja elementu WriteToServer(DataTable), która kopiuje wszystkie wiersze podane DataTable do tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

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

Parametry

table

DataTable

A DataTable którego wiersze zostaną skopiowane do tabeli docelowej.

cancellationToken

CancellationToken

Instrukcja anulowania. Wartość None w tym parametrze sprawia, że ta metoda jest równoważna WriteToServerAsync(DataTable).

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie WriteToServerAsync(DataTable) wiele razy dla tego samego wystąpienia przed ukończeniem zadania.

Wywołanie WriteToServerAsync(DataTable) i WriteToServer(DataTable) dla tego samego wystąpienia przed ukończeniem zadania.

Połączenie spada lub jest zamykane podczas WriteToServerAsync(DataTable) wykonywania.

Zwrócony w obiekcie SqlBulkCopy zadania obiekt został zamknięty podczas wykonywania metody.

Zwrócony w obiekcie zadania wystąpił limit czasu puli połączeń.

Zwrócony w obiekcie SqlConnection zadania obiekt jest zamknięty przed wykonaniem metody.

Context Connection=truejest określony w parametry połączenia.

SqlException

Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez WriteToServer(DataTable)usługę .

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Wersja WriteToServer(DataTable, DataRowState)asynchroniczna programu , która kopiuje tylko wiersze zgodne z podanym stanem wiersza w dostarczonej DataTable tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.

Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Task.

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

Parametry

table

DataTable

Obiekt DataTable , którego wiersze zostaną skopiowane do tabeli docelowej.

rowState

DataRowState

Wartość z DataRowState wyliczenia. Do miejsca docelowego są kopiowane tylko wiersze pasujące do stanu wiersza.

cancellationToken

CancellationToken

Instrukcja anulowania. Wartość None w tym parametrze sprawia, że ta metoda jest równoważna WriteToServerAsync(DataTable).

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidOperationException

Wywołanie WriteToServerAsync(DataTable, DataRowState) wiele razy dla tego samego wystąpienia przed ukończeniem zadania.

Wywołanie WriteToServerAsync(DataTable, DataRowState) i WriteToServer(DataTable, DataRowState) dla tego samego wystąpienia przed ukończeniem zadania.

Połączenie spada lub jest zamykane podczas WriteToServerAsync(DataTable, DataRowState) wykonywania.

Zwrócony w obiekcie SqlBulkCopy zadania obiekt został zamknięty podczas wykonywania metody.

Zwrócony w obiekcie zadania wystąpił limit czasu puli połączeń.

Zwrócony w obiekcie SqlConnection zadania obiekt jest zamknięty przed wykonaniem metody.

Context Connection=trueparametr jest określony w parametry połączenia.

SqlException

Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w programie .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez WriteToServer(DataTable, DataRowState)usługę .