SqlBulkCopy.WriteToServerAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 UseInternalTransaction je zadána hodnota .
Pokud máte vlastní transakci.
Hodnota .BatchSize
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.TaskPublic Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As TaskParametry
- 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
Úloha představující asynchronní operaci
Výjimky
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.
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í.
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader) As TaskParametry
- reader
- DbDataReader
A DbDataReader , jehož řádky budou zkopírovány do cílové tabulky.
Návraty
Ú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.TaskPublic Function WriteToServerAsync (rows As DataRow()) As TaskParametry
Návraty
Úloha představující asynchronní operaci
Výjimky
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.
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.TaskPublic Function WriteToServerAsync (table As DataTable) As TaskParametry
Návraty
Úloha představující asynchronní operaci
Výjimky
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.
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.TaskPublic Function WriteToServerAsync (reader As IDataReader) As TaskParametry
- reader
- IDataReader
A IDataReader , jehož řádky budou zkopírovány do cílové tabulky.
Návraty
Úloha představující asynchronní operaci
Výjimky
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.
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As TaskParametry
- 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
Vrací objekt Task.
Výjimky
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.TaskPublic Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As TaskParametry
- cancellationToken
- CancellationToken
Instrukce zrušení Hodnota None v tomto parametru činí tuto metodu ekvivalentní hodnotě WriteToServerAsync(DataTable).
Návraty
Úloha představující asynchronní operaci
Výjimky
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.
Vrácená v objektu úkolu, všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As TaskParametry
- rowState
- DataRowState
Hodnota z výčtu DataRowState . Do cíle se zkopírují jenom řádky odpovídající stavu řádku.
Návraty
Úloha představující asynchronní operaci
Výjimky
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.
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.TaskPublic Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As TaskParametry
- cancellationToken
- CancellationToken
Instrukce zrušení Hodnota None v tomto parametru činí tuto metodu ekvivalentní hodnotě WriteToServerAsync(DataTable).
Návraty
Úloha představující asynchronní operaci
Výjimky
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.
Vrácená v objektu úkolu, všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As TaskParametry
- 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
Úloha představující asynchronní operaci
Výjimky
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.
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í.
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
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro