SqlBulkCopy.WriteToServerAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
| Nazwa | Opis |
|---|---|
| WriteToServerAsync(IDataReader, CancellationToken) |
Asynchroniczna wersja WriteToServer(IDataReader)programu , która kopiuje wszystkie wiersze w dostarczonej IDataReader tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. Token anulowania może służyć do żądania porzucenia operacji przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania. |
| WriteToServerAsync(DbDataReader) |
Asynchroniczna wersja WriteToServer(DbDataReader)elementu , 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 WriteToServer(DataRow[])elementu , 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 WriteToServer(DataTable)programu , która kopiuje wszystkie wiersze w dostarczonej DataTable tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. |
| WriteToServerAsync(IDataReader) |
Asynchroniczna wersja WriteToServer(IDataReader)programu , która kopiuje wszystkie wiersze w dostarczonej IDataReader tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. |
| WriteToServerAsync(DbDataReader, CancellationToken) |
Asynchroniczna wersja WriteToServer(DbDataReader)elementu , 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 WriteToServer(DataRow[])elementu , 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 porzucenia operacji przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania. |
| WriteToServerAsync(DataTable, DataRowState) |
Asynchroniczna wersja WriteToServer(DataTable, DataRowState)programu , która kopiuje tylko wiersze zgodne ze stanem podanego wiersza w tabeli DataTable docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. |
| WriteToServerAsync(DataTable, CancellationToken) |
Asynchroniczna wersja WriteToServer(DataTable)programu , która kopiuje wszystkie wiersze w dostarczonej DataTable tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. Token anulowania może służyć do żądania porzucenia operacji przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania. |
| WriteToServerAsync(DataTable, DataRowState, CancellationToken) |
Asynchroniczna wersja WriteToServer(DataTable, DataRowState)programu , która kopiuje tylko wiersze zgodne ze stanem podanego wiersza w tabeli DataTable docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu. Token anulowania może służyć do żądania porzucenia operacji 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żesz przeplatać wywołania WriteToServer z innymi poleceniami w tym samym połączeniu.
Liczba wierszy, które są wycofywane, gdy jeden kończy się niepowodzeniem, zależy od kilku rzeczy:
Jeśli UseInternalTransaction zostanie określony.
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 z wszystkimi poprzednimi partiami).
Użyj SqlRowsCopied polecenia , aby dowiedzieć się, ile wierszy zostało skopiowanych na serwer.
WriteToServerAsync(IDataReader, CancellationToken)
Asynchroniczna wersja WriteToServer(IDataReader)programu , która kopiuje wszystkie wiersze w dostarczonej IDataReader tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
Token anulowania może służyć do żądania porzucenia operacji 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
Obiekt 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
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
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 przerywa 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 zamykany 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=true jest określony w parametry połączenia.
Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(IDataReader).
Dotyczy
WriteToServerAsync(DbDataReader)
Asynchroniczna wersja WriteToServer(DbDataReader)elementu , 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
Obiekt DbDataReader , którego wiersze zostaną skopiowane do tabeli docelowej.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Uwagi
Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(DbDataReader).
Dotyczy
WriteToServerAsync(DataRow[])
Asynchroniczna wersja WriteToServer(DataRow[])elementu , 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
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
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 przerywa 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 zamykany przed wykonaniem metody.
Context Connection=true jest określony w parametry połączenia.
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 Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(DataRow[]).
Dotyczy
WriteToServerAsync(DataTable)
Asynchroniczna wersja WriteToServer(DataTable)programu , która kopiuje wszystkie wiersze w dostarczonej DataTable 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
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
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 przerywa 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 zamykany przed wykonaniem metody.
Context Connection=true jest określony w parametry połączenia.
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 Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(DataTable).
Dotyczy
WriteToServerAsync(IDataReader)
Asynchroniczna wersja WriteToServer(IDataReader)programu , która kopiuje wszystkie wiersze w dostarczonej IDataReader 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
Obiekt IDataReader , którego wiersze zostaną skopiowane do tabeli docelowej.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
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 przerywa 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 zamykany 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=true jest określony w parametry połączenia.
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 Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(IDataReader).
Dotyczy
WriteToServerAsync(DbDataReader, CancellationToken)
Asynchroniczna wersja WriteToServer(DbDataReader)elementu , 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
Obiekt 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
Zwraca wartość Task.
Wyjątki
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(DbDataReader).
Dotyczy
WriteToServerAsync(DataRow[], CancellationToken)
Asynchroniczna wersja WriteToServer(DataRow[])elementu , 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 porzucenia operacji 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
- cancellationToken
- CancellationToken
Instrukcja anulowania. Wartość None w tym parametrze sprawia, że ta metoda jest równoważna .WriteToServerAsync(DataTable)
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
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 przerywa 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 zamykany przed wykonaniem metody.
Context Connection=true jest określony w parametry połączenia.
Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(DataRow[]).
Dotyczy
WriteToServerAsync(DataTable, DataRowState)
Asynchroniczna wersja WriteToServer(DataTable, DataRowState)programu , która kopiuje tylko wiersze zgodne ze stanem podanego wiersza w tabeli DataTable 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
- rowState
- DataRowState
Wartość z DataRowState wyliczenia. Do miejsca docelowego są kopiowane tylko wiersze pasujące do stanu wiersza.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
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 przerywa 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 zamykany przed wykonaniem metody.
Context Connection=true jest określony w parametry połączenia.
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 Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(DataTable, DataRowState).
Dotyczy
WriteToServerAsync(DataTable, CancellationToken)
Asynchroniczna wersja WriteToServer(DataTable)programu , która kopiuje wszystkie wiersze w dostarczonej DataTable tabeli docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
Token anulowania może służyć do żądania porzucenia operacji 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
- cancellationToken
- CancellationToken
Instrukcja anulowania. Wartość None w tym parametrze sprawia, że ta metoda jest równoważna .WriteToServerAsync(DataTable)
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
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 przerywa 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 zamykany przed wykonaniem metody.
Context Connection=true jest określony w parametry połączenia.
Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(DataTable).
Dotyczy
WriteToServerAsync(DataTable, DataRowState, CancellationToken)
Asynchroniczna wersja WriteToServer(DataTable, DataRowState)programu , która kopiuje tylko wiersze zgodne ze stanem podanego wiersza w tabeli DataTable docelowej określonej przez DestinationTableName właściwość SqlBulkCopy obiektu.
Token anulowania może służyć do żądania porzucenia operacji 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::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
- 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
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
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 przerywa 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 zamykany przed wykonaniem metody.
Context Connection=true jest określony w parametry połączenia.
Zwrócony w obiekcie zadania wszelkie błędy zwrócone przez SQL Server, które wystąpiły podczas otwierania połączenia.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. 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 program WriteToServer(DataTable, DataRowState).