Sdílet prostřednictvím

SqlBulkCopy.WriteToServerAsync Metoda

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.dll
Sestavení:
netstandard.dll, System.Data.SqlClient.dll
Sestavení:
System.Data.SqlClient.dll
Balíček:
System.Data.SqlClient v4.8.6

Asynchronní verze nástroje WriteToServer, která kopíruje všechny řádky ze zdroje dat do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Přetížení

WriteToServerAsync(IDataReader, CancellationToken)

Asynchronní verze nástroje WriteToServer(IDataReader), která kopíruje všechny řádky v zadaném IDataReader objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Token zrušení lze použít k vyžádání, aby byla operace zrušena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
WriteToServerAsync(DbDataReader)

Asynchronní verze , WriteToServer(DbDataReader)která kopíruje všechny řádky ze zadaného DbDataReader pole do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .
WriteToServerAsync(DataRow[])

Asynchronní verze , WriteToServer(DataRow[])která kopíruje všechny řádky ze zadaného DataRow pole do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .
WriteToServerAsync(DataTable)

Asynchronní verze nástroje WriteToServer(DataTable), která kopíruje všechny řádky v zadaném DataTable objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .
WriteToServerAsync(IDataReader)

Asynchronní verze nástroje WriteToServer(IDataReader), která kopíruje všechny řádky v zadaném IDataReader objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .
WriteToServerAsync(DbDataReader, CancellationToken)

Asynchronní verze , WriteToServer(DbDataReader)která kopíruje všechny řádky ze zadaného DbDataReader pole do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .
WriteToServerAsync(DataRow[], CancellationToken)

Asynchronní verze , WriteToServer(DataRow[])která kopíruje všechny řádky ze zadaného DataRow pole do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Token zrušení lze použít k vyžádání, aby byla operace zrušena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
WriteToServerAsync(DataTable, DataRowState)

Asynchronní verze nástroje WriteToServer(DataTable, DataRowState), která kopíruje pouze řádky, které odpovídají zadanému stavu řádku v zadaném DataTable objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .
WriteToServerAsync(DataTable, CancellationToken)

Asynchronní verze nástroje WriteToServer(DataTable), která kopíruje všechny řádky v zadaném DataTable objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Token zrušení lze použít k vyžádání, aby byla operace zrušena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Asynchronní verze nástroje WriteToServer(DataTable, DataRowState), která kopíruje pouze řádky, které odpovídají zadanému stavu řádku v zadaném DataTable objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Token zrušení lze použít k vyžádání, aby byla operace zrušena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

Poznámky

Pokud je zakázáno WriteToServer více aktivních sad výsledků (MARS), připojení je zaneprázdněné. Pokud je služba MARS povolená, můžete prokládání volání WriteToServer s jinými příkazy ve stejném připojení.

Počet řádků, které se vrátí zpět, když jeden selže, závisí na několika věcech:

Pokud při odesílání dat na server dojde k chybě, aktuální dávka (podle parametru BatchSize) se vrátí zpět. Pokud UseInternalTransaction není zadaný a máte vlastní transakci, vrátí se zpět celá transakce (která zahrnuje i všechny předchozí dávky).

Umožňuje SqlRowsCopied zjistit, kolik řádků bylo zkopírováno na server.

WriteToServerAsync(IDataReader, CancellationToken)

Asynchronní verze nástroje WriteToServer(IDataReader), která kopíruje všechny řádky v zadaném IDataReader objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Token zrušení lze použít k vyžádání, aby byla operace zrušena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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 , jehož řádky budou zkopírovány do cílové tabulky.

cancellationToken
CancellationToken

Instrukce zrušení Hodnota None v tomto parametru činí tuto metodu ekvivalentní hodnotě WriteToServerAsync(DataTable).

Návraty

Task

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání WriteToServerAsync(IDataReader) vícekrát pro stejnou instanci před dokončením úkolu.

Volání WriteToServerAsync(IDataReader) a WriteToServer(IDataReader) pro stejnou instanci před dokončením úlohy.

Připojení se během WriteToServerAsync(IDataReader) provádění ukončí nebo se ukončí.

Vrácený v objektu úlohy, SqlBulkCopy objekt byl zavřený během provádění metody.

Vrácený v objektu úkolu, došlo k vypršení časového limitu fondu připojení.

Vrácený v objektu úlohy, SqlConnection objekt je uzavřen před spuštěním metody.

Byla IDataReader uzavřena před vrácením dokončeného Task souboru.

Přidružené IDataReaderpřipojení bylo ukončeno před vrácením dokončeného Task připojení.

Context Connection=trueje zadaný v připojovací řetězec.

SqlException

V objektu úlohy se vrátily všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Další informace o asynchronním programování ve zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(IDataReader).

Platí pro

WriteToServerAsync(DbDataReader)

Asynchronní verze , WriteToServer(DbDataReader)která kopíruje všechny řádky ze zadaného DbDataReader pole do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

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 , jehož řádky budou zkopírovány do cílové tabulky.

Návraty

Task

Úloha představující asynchronní operaci

Poznámky

Další informace o asynchronním programování ve zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(DbDataReader).

Platí pro

WriteToServerAsync(DataRow[])

Asynchronní verze , WriteToServer(DataRow[])která kopíruje všechny řádky ze zadaného DataRow pole do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

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[]

Pole DataRow objektů, které budou zkopírovány do cílové tabulky.

Návraty

Task

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání WriteToServerAsync(DataRow[]) vícekrát pro stejnou instanci před dokončením úkolu.

Volání WriteToServerAsync(DataRow[]) a WriteToServer(DataRow[]) pro stejnou instanci před dokončením úlohy.

Připojení se během WriteToServerAsync(DataRow[]) provádění ukončí nebo se ukončí.

Vrácený v objektu úlohy, SqlBulkCopy objekt byl zavřený během provádění metody.

Vrácený v objektu úkolu, došlo k vypršení časového limitu fondu připojení.

Vrácený v objektu úlohy, SqlConnection objekt je uzavřen před spuštěním metody.

Context Connection=trueje zadaný v připojovací řetězec.

SqlException

V objektu úlohy se vrátily všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.

Poznámky

Další informace o asynchronním programování ve zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(DataRow[]).

Platí pro

WriteToServerAsync(DataTable)

Asynchronní verze , WriteToServer(DataTable)která zkopíruje všechny řádky v zadaném DataTable objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

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 , jehož řádky budou zkopírovány do cílové tabulky.

Návraty

Task

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání WriteToServerAsync(DataTable) vícekrát pro stejnou instanci před dokončením úkolu.

Volání WriteToServerAsync(DataTable) a WriteToServer(DataTable) pro stejnou instanci před dokončením úlohy.

Připojení se během WriteToServerAsync(DataTable) provádění ukončí nebo se ukončí.

Vrácený v objektu úlohy, SqlBulkCopy objekt byl zavřený během provádění metody.

Vrácený v objektu úkolu, došlo k vypršení časového limitu fondu připojení.

Vrácený v objektu úlohy, SqlConnection objekt je uzavřen před spuštěním metody.

Context Connection=trueje zadaný v připojovací řetězec.

SqlException

V objektu úlohy se vrátily všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.

Poznámky

Další informace o asynchronním programování ve zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(DataTable).

Platí pro

WriteToServerAsync(IDataReader)

Asynchronní verze , WriteToServer(IDataReader)která zkopíruje všechny řádky v zadaném IDataReader objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

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 , jehož řádky budou zkopírovány do cílové tabulky.

Návraty

Task

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání WriteToServerAsync(IDataReader) vícekrát pro stejnou instanci před dokončením úkolu

Volání WriteToServerAsync(IDataReader) a WriteToServer(IDataReader) pro stejnou instanci před dokončením úkolu

Připojení se ukončí nebo se ukončí během WriteToServerAsync(IDataReader) provádění.

Vrácený v objektu úkolu, SqlBulkCopy objekt byl uzavřen během provádění metody.

V objektu úkolu došlo k vypršení časového limitu fondu připojení.

Vráceno v objektu úlohy, SqlConnection objekt je uzavřen před spuštěním metody.

Před IDataReader vrácením dokončeného byla uzavřena Task .

Přidružené IDataReaderpřipojení bylo před vrácením dokončeného Task připojení uzavřeno.

Context Connection=trueje zadáno v připojovací řetězec.

SqlException

Vrácená v objektu úkolu, všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(IDataReader).

Platí pro

WriteToServerAsync(DbDataReader, CancellationToken)

Asynchronní verze nástroje WriteToServer(DbDataReader), která kopíruje všechny řádky ze zadaného DbDataReader pole do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

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 , jehož řádky budou zkopírovány do cílové tabulky.

cancellationToken
CancellationToken

Instrukce zrušení Hodnota None v tomto parametru činí tuto metodu ekvivalentní hodnotě WriteToServerAsync(DbDataReader).

Návraty

Task

Vrací objekt Task.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(DbDataReader).

Platí pro

WriteToServerAsync(DataRow[], CancellationToken)

Asynchronní verze nástroje WriteToServer(DataRow[]), která kopíruje všechny řádky ze zadaného DataRow pole do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Token zrušení lze použít k žádosti o opuštění operace před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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[]

Pole DataRow objektů, které se zkopírují do cílové tabulky.

cancellationToken
CancellationToken

Instrukce zrušení Hodnota None v tomto parametru činí tuto metodu ekvivalentní hodnotě WriteToServerAsync(DataTable).

Návraty

Task

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání WriteToServerAsync(DataRow[]) vícekrát pro stejnou instanci před dokončením úkolu

Volání WriteToServerAsync(DataRow[]) a WriteToServer(DataRow[]) pro stejnou instanci před dokončením úkolu

Připojení se ukončí nebo se ukončí během WriteToServerAsync(DataRow[]) provádění.

Vrácený v objektu úkolu, SqlBulkCopy objekt byl uzavřen během provádění metody.

V objektu úkolu došlo k vypršení časového limitu fondu připojení.

Vráceno v objektu úlohy, SqlConnection objekt je uzavřen před spuštěním metody.

Context Connection=trueje zadáno v připojovací řetězec.

SqlException

Vrácená v objektu úkolu, všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(DataRow[]).

Platí pro

WriteToServerAsync(DataTable, DataRowState)

Asynchronní verze , WriteToServer(DataTable, DataRowState)která kopíruje pouze řádky, které odpovídají zadanému stavu řádku v zadané DataTable cílové tabulce určené DestinationTableName vlastností objektu SqlBulkCopy .

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 , jehož řádky budou zkopírovány do cílové tabulky.

rowState
DataRowState

Hodnota z výčtu DataRowState . Do cíle se zkopírují jenom řádky odpovídající stavu řádku.

Návraty

Task

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání WriteToServerAsync(DataTable, DataRowState) vícekrát pro stejnou instanci před dokončením úkolu

Volání WriteToServerAsync(DataTable, DataRowState) a WriteToServer(DataTable, DataRowState) pro stejnou instanci před dokončením úkolu

Připojení se ukončí nebo se ukončí během WriteToServerAsync(DataTable, DataRowState) provádění.

Vrácený v objektu úkolu, SqlBulkCopy objekt byl uzavřen během provádění metody.

V objektu úkolu došlo k vypršení časového limitu fondu připojení.

Vráceno v objektu úlohy, SqlConnection objekt je uzavřen před spuštěním metody.

Context Connection=trueje zadáno v připojovací řetězec.

SqlException

Vrácená v objektu úkolu, všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(DataTable, DataRowState).

Platí pro

WriteToServerAsync(DataTable, CancellationToken)

Asynchronní verze , WriteToServer(DataTable)která zkopíruje všechny řádky v zadaném DataTable objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Token zrušení lze použít k žádosti o opuštění operace před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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 , jehož řádky budou zkopírovány do cílové tabulky.

cancellationToken
CancellationToken

Instrukce zrušení Hodnota None v tomto parametru činí tuto metodu ekvivalentní hodnotě WriteToServerAsync(DataTable).

Návraty

Task

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání WriteToServerAsync(DataTable) vícekrát pro stejnou instanci před dokončením úkolu

Volání WriteToServerAsync(DataTable) a WriteToServer(DataTable) pro stejnou instanci před dokončením úkolu

Připojení se ukončí nebo se ukončí během WriteToServerAsync(DataTable) provádění.

Vrácený v objektu úkolu, SqlBulkCopy objekt byl uzavřen během provádění metody.

V objektu úkolu došlo k vypršení časového limitu fondu připojení.

Vráceno v objektu úlohy, SqlConnection objekt je uzavřen před spuštěním metody.

Context Connection=trueje zadáno v připojovací řetězec.

SqlException

Vrácená v objektu úkolu, všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(DataTable).

Platí pro

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Asynchronní verze nástroje WriteToServer(DataTable, DataRowState), která kopíruje pouze řádky, které odpovídají zadanému stavu řádku v zadaném DataTable objektu do cílové tabulky určené DestinationTableName vlastností objektu SqlBulkCopy .

Token zrušení lze použít k vyžádání, aby byla operace zrušena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu 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

A DataTable , jehož řádky budou zkopírovány do cílové tabulky.

rowState
DataRowState

Hodnota z výčtu DataRowState . Do cíle se zkopírují jenom řádky odpovídající stavu řádku.

cancellationToken
CancellationToken

Instrukce zrušení Hodnota None v tomto parametru činí tuto metodu ekvivalentní hodnotě WriteToServerAsync(DataTable).

Návraty

Task

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání WriteToServerAsync(DataTable, DataRowState) vícekrát pro stejnou instanci před dokončením úkolu

Volání WriteToServerAsync(DataTable, DataRowState) a WriteToServer(DataTable, DataRowState) pro stejnou instanci před dokončením úkolu

Připojení se ukončí nebo se ukončí během WriteToServerAsync(DataTable, DataRowState) provádění.

Vrácený v objektu úkolu, SqlBulkCopy objekt byl uzavřen během provádění metody.

V objektu úkolu došlo k vypršení časového limitu fondu připojení.

Vráceno v objektu úlohy, SqlConnection objekt je uzavřen před spuštěním metody.

Context Connection=trueje zadaný v připojovací řetězec.

SqlException

V objektu úlohy se vrátily všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Další informace o asynchronním programování ve zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteToServer(DataTable, DataRowState).

Platí pro