SqlBulkCopy.WriteToServerAsync Metod

Definition

Namnområde:: System.Data.SqlClient

Sammansättning:: System.Data.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

En asynkron version av WriteToServer, som kopierar alla rader från en datakälla till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

Överlagringar

Name	Description
WriteToServerAsync(IDataReader, CancellationToken)	Den asynkrona versionen av WriteToServer(IDataReader), som kopierar alla rader i den angivna IDataReader till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap. Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.
WriteToServerAsync(DbDataReader)	Den asynkrona versionen av WriteToServer(DbDataReader), som kopierar alla rader från den angivna DbDataReader matrisen till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.
WriteToServerAsync(DataRow[])	Den asynkrona versionen av WriteToServer(DataRow[]), som kopierar alla rader från den angivna DataRow matrisen till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.
WriteToServerAsync(DataTable)	Den asynkrona versionen av WriteToServer(DataTable), som kopierar alla rader i den angivna DataTable till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.
WriteToServerAsync(IDataReader)	Den asynkrona versionen av WriteToServer(IDataReader), som kopierar alla rader i den angivna IDataReader till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.
WriteToServerAsync(DbDataReader, CancellationToken)	Den asynkrona versionen av WriteToServer(DbDataReader), som kopierar alla rader från den angivna DbDataReader matrisen till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.
WriteToServerAsync(DataRow[], CancellationToken)	Den asynkrona versionen av WriteToServer(DataRow[]), som kopierar alla rader från den angivna DataRow matrisen till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap. Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.
WriteToServerAsync(DataTable, DataRowState)	Den asynkrona versionen av WriteToServer(DataTable, DataRowState), som endast kopierar rader som matchar det angivna radtillståndet i den angivna DataTable till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.
WriteToServerAsync(DataTable, CancellationToken)	Den asynkrona versionen av WriteToServer(DataTable), som kopierar alla rader i den angivna DataTable till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap. Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	Den asynkrona versionen av WriteToServer(DataTable, DataRowState), som endast kopierar rader som matchar det angivna radtillståndet i den angivna DataTable till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap. Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.

Kommentarer

Om flera aktiva resultatuppsättningar (MARS) är inaktiverat gör WriteToServer anslutningen upptagen. Om MARS är aktiverat kan du koppla anrop till WriteToServer med andra kommandon i samma anslutning.

Antalet rader som återställs när en misslyckas beror på flera saker:

Om UseInternalTransaction anges.
Om du har en egen transaktion.
Värdet för BatchSize.

När det uppstår ett fel när data skickas till servern återställs den aktuella batchen (enligt ) BatchSize. Om UseInternalTransaction inte har angetts och du har en egen transaktion återställs hela transaktionen (vilket även omfattar alla tidigare batchar).

Använd SqlRowsCopied för att veta hur många rader som kopierades till servern.

WriteToServerAsync(IDataReader, CancellationToken)

Den asynkrona versionen av WriteToServer(IDataReader), som kopierar alla rader i den angivna IDataReader till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.

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

Parametrar

reader: IDataReader

En IDataReader vars rader kommer att kopieras till måltabellen.

cancellationToken: CancellationToken

Instruktionen för annullering. Ett None värde i den här parametern gör att den här metoden motsvarar WriteToServerAsync(DataTable).

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

Anropa WriteToServerAsync(IDataReader) flera gånger för samma instans innan aktiviteten slutförs.

Anropa WriteToServerAsync(IDataReader) och WriteToServer(IDataReader) för samma instans innan uppgiften slutförs.

Anslutningen avbryts eller stängs under WriteToServerAsync(IDataReader) körningen.

Objektet som returnerades i aktivitetsobjektet SqlBulkCopy stängdes under metodkörningen.

Det gick inte att överskrida tidsgränsen för anslutningspoolen som returnerades i aktivitetsobjektet.

Objektet som returneras i aktivitetsobjektet SqlConnection stängs innan metoden körs.

Stängdes IDataReader innan den slutförda Task returnerades.

Den IDataReaderassocierade anslutningen stängdes innan den slutförda Task returnerades.

Context Connection=true anges i reťazec pripojenia.

SqlException

Returneras i aktivitetsobjektet, alla fel som returneras av SQL Server som inträffade när anslutningen öppnades.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av WriteToServer(IDataReader).

Gäller för

WriteToServerAsync(DbDataReader)

Den asynkrona versionen av WriteToServer(DbDataReader), som kopierar alla rader från den angivna DbDataReader matrisen till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

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

Parametrar

reader: DbDataReader

En DbDataReader vars rader kommer att kopieras till måltabellen.

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Gäller för

WriteToServerAsync(DataRow[])

Den asynkrona versionen av WriteToServer(DataRow[]), som kopierar alla rader från den angivna DataRow matrisen till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

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

Parametrar

rows: DataRow[]

En matris med DataRow objekt som ska kopieras till måltabellen.

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

Anropa WriteToServerAsync(DataRow[]) flera gånger för samma instans innan aktiviteten slutförs.

Anropa WriteToServerAsync(DataRow[]) och WriteToServer(DataRow[]) för samma instans innan uppgiften slutförs.

Anslutningen avbryts eller stängs under WriteToServerAsync(DataRow[]) körningen.

Objektet som returnerades i aktivitetsobjektet SqlBulkCopy stängdes under metodkörningen.

Det gick inte att överskrida tidsgränsen för anslutningspoolen som returnerades i aktivitetsobjektet.

Objektet som returneras i aktivitetsobjektet SqlConnection stängs innan metoden körs.

Context Connection=true anges i reťazec pripojenia.

SqlException

Returneras i aktivitetsobjektet, alla fel som returneras av SQL Server som inträffade när anslutningen öppnades.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Gäller för

WriteToServerAsync(DataTable)

Den asynkrona versionen av WriteToServer(DataTable), som kopierar alla rader i den angivna DataTable till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

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

Parametrar

table: DataTable

En DataTable vars rader kommer att kopieras till måltabellen.

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

Anropa WriteToServerAsync(DataTable) flera gånger för samma instans innan aktiviteten slutförs.

Anropa WriteToServerAsync(DataTable) och WriteToServer(DataTable) för samma instans innan uppgiften slutförs.

Anslutningen avbryts eller stängs under WriteToServerAsync(DataTable) körningen.

Objektet som returnerades i aktivitetsobjektet SqlBulkCopy stängdes under metodkörningen.

Det gick inte att överskrida tidsgränsen för anslutningspoolen som returnerades i aktivitetsobjektet.

Objektet som returneras i aktivitetsobjektet SqlConnection stängs innan metoden körs.

Context Connection=true anges i reťazec pripojenia.

SqlException

Returneras i aktivitetsobjektet, alla fel som returneras av SQL Server som inträffade när anslutningen öppnades.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Gäller för

WriteToServerAsync(IDataReader)

Den asynkrona versionen av WriteToServer(IDataReader), som kopierar alla rader i den angivna IDataReader till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

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

Parametrar

reader: IDataReader

En IDataReader vars rader kommer att kopieras till måltabellen.

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

Anropa WriteToServerAsync(IDataReader) flera gånger för samma instans innan aktiviteten slutförs.

Anropa WriteToServerAsync(IDataReader) och WriteToServer(IDataReader) för samma instans innan uppgiften slutförs.

Anslutningen avbryts eller stängs under WriteToServerAsync(IDataReader) körningen.

Objektet som returnerades i aktivitetsobjektet SqlBulkCopy stängdes under metodkörningen.

Det gick inte att överskrida tidsgränsen för anslutningspoolen som returnerades i aktivitetsobjektet.

Objektet som returneras i aktivitetsobjektet SqlConnection stängs innan metoden körs.

Stängdes IDataReader innan den slutförda Task returnerades.

Den IDataReaderassocierade anslutningen stängdes innan den slutförda Task returnerades.

Context Connection=true anges i reťazec pripojenia.

SqlException

Returneras i aktivitetsobjektet, alla fel som returneras av SQL Server som inträffade när anslutningen öppnades.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Gäller för

WriteToServerAsync(DbDataReader, CancellationToken)

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

Parametrar

reader: DbDataReader

En DbDataReader vars rader kommer att kopieras till måltabellen.

cancellationToken: CancellationToken

Instruktionen för annullering. Ett None värde i den här parametern gör att den här metoden motsvarar WriteToServerAsync(DbDataReader).

Returer

Task

Returnerar Task.

Undantag

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Gäller för

WriteToServerAsync(DataRow[], CancellationToken)

Den asynkrona versionen av WriteToServer(DataRow[]), som kopierar alla rader från den angivna DataRow matrisen till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.

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

Parametrar

rows: DataRow[]

En matris med DataRow objekt som ska kopieras till måltabellen.

cancellationToken: CancellationToken

Instruktionen för annullering. Ett None värde i den här parametern gör att den här metoden motsvarar WriteToServerAsync(DataTable).

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

Anropa WriteToServerAsync(DataRow[]) flera gånger för samma instans innan aktiviteten slutförs.

Anropa WriteToServerAsync(DataRow[]) och WriteToServer(DataRow[]) för samma instans innan uppgiften slutförs.

Anslutningen avbryts eller stängs under WriteToServerAsync(DataRow[]) körningen.

Objektet som returnerades i aktivitetsobjektet SqlBulkCopy stängdes under metodkörningen.

Det gick inte att överskrida tidsgränsen för anslutningspoolen som returnerades i aktivitetsobjektet.

Objektet som returneras i aktivitetsobjektet SqlConnection stängs innan metoden körs.

Context Connection=true anges i reťazec pripojenia.

SqlException

Returneras i aktivitetsobjektet, alla fel som returneras av SQL Server som inträffade när anslutningen öppnades.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Gäller för

WriteToServerAsync(DataTable, DataRowState)

Den asynkrona versionen av WriteToServer(DataTable, DataRowState), som endast kopierar rader som matchar det angivna radtillståndet i den angivna DataTable till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

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

Parametrar

table: DataTable

En DataTable vars rader kommer att kopieras till måltabellen.

rowState: DataRowState

Ett värde från DataRowState uppräkningen. Endast rader som matchar radtillståndet kopieras till målet.

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

Anropa WriteToServerAsync(DataTable, DataRowState) flera gånger för samma instans innan aktiviteten slutförs.

Anropa WriteToServerAsync(DataTable, DataRowState) och WriteToServer(DataTable, DataRowState) för samma instans innan uppgiften slutförs.

Anslutningen avbryts eller stängs under WriteToServerAsync(DataTable, DataRowState) körningen.

Objektet som returnerades i aktivitetsobjektet SqlBulkCopy stängdes under metodkörningen.

Det gick inte att överskrida tidsgränsen för anslutningspoolen som returnerades i aktivitetsobjektet.

Objektet som returneras i aktivitetsobjektet SqlConnection stängs innan metoden körs.

Context Connection=true anges i reťazec pripojenia.

SqlException

Returneras i aktivitetsobjektet, alla fel som returneras av SQL Server som inträffade när anslutningen öppnades.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Gäller för

WriteToServerAsync(DataTable, CancellationToken)

Den asynkrona versionen av WriteToServer(DataTable), som kopierar alla rader i den angivna DataTable till en måltabell som anges av DestinationTableName objektets SqlBulkCopy egenskap.

Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.

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

Parametrar

table: DataTable

En DataTable vars rader kommer att kopieras till måltabellen.

cancellationToken: CancellationToken

Instruktionen för annullering. Ett None värde i den här parametern gör att den här metoden motsvarar WriteToServerAsync(DataTable).

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

Anropa WriteToServerAsync(DataTable) flera gånger för samma instans innan aktiviteten slutförs.

Anropa WriteToServerAsync(DataTable) och WriteToServer(DataTable) för samma instans innan uppgiften slutförs.

Anslutningen avbryts eller stängs under WriteToServerAsync(DataTable) körningen.

Objektet som returnerades i aktivitetsobjektet SqlBulkCopy stängdes under metodkörningen.

Det gick inte att överskrida tidsgränsen för anslutningspoolen som returnerades i aktivitetsobjektet.

Objektet som returneras i aktivitetsobjektet SqlConnection stängs innan metoden körs.

Context Connection=true anges i reťazec pripojenia.

SqlException

Returneras i aktivitetsobjektet, alla fel som returneras av SQL Server som inträffade när anslutningen öppnades.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Gäller för

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för kommandot förflutit. Undantag rapporteras via det returnerade aktivitetsobjektet.

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

Parametrar

table: DataTable

En DataTable vars rader kommer att kopieras till måltabellen.

rowState: DataRowState

Ett värde från DataRowState uppräkningen. Endast rader som matchar radtillståndet kopieras till målet.

cancellationToken: CancellationToken

Instruktionen för annullering. Ett None värde i den här parametern gör att den här metoden motsvarar WriteToServerAsync(DataTable).

Returer

Task

En uppgift som representerar den asynkrona åtgärden.

Undantag

InvalidOperationException

Anropa WriteToServerAsync(DataTable, DataRowState) flera gånger för samma instans innan aktiviteten slutförs.

Anropa WriteToServerAsync(DataTable, DataRowState) och WriteToServer(DataTable, DataRowState) för samma instans innan uppgiften slutförs.

Anslutningen avbryts eller stängs under WriteToServerAsync(DataTable, DataRowState) körningen.

Objektet som returnerades i aktivitetsobjektet SqlBulkCopy stängdes under metodkörningen.

Det gick inte att överskrida tidsgränsen för anslutningspoolen som returnerades i aktivitetsobjektet.

Objektet som returneras i aktivitetsobjektet SqlConnection stängs innan metoden körs.

Context Connection=true anges i reťazec pripojenia.

SqlException

Returneras i aktivitetsobjektet, alla fel som returneras av SQL Server som inträffade när anslutningen öppnades.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.

Gäller för

Feedback

Var den här sidan till hjälp?