SqlBulkCopy.WriteToServerAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Een asynchrone versie van WriteToServer, waarmee alle rijen van een gegevensbron worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
Overloads
| Name | Description |
|---|---|
| WriteToServerAsync(IDataReader, CancellationToken) |
De asynchrone versie van WriteToServer(IDataReader), waarmee alle rijen in de opgegeven naar een doeltabel worden gekopieerd IDataReader die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject. |
| WriteToServerAsync(DbDataReader) |
De asynchrone versie van WriteToServer(DbDataReader), waarmee alle rijen van de opgegeven DbDataReader matrix worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. |
| WriteToServerAsync(DataRow[]) |
De asynchrone versie van WriteToServer(DataRow[]), waarmee alle rijen van de opgegeven DataRow matrix worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. |
| WriteToServerAsync(DataTable) |
De asynchrone versie van WriteToServer(DataTable), waarmee alle rijen in de opgegeven naar een doeltabel worden gekopieerd DataTable die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. |
| WriteToServerAsync(IDataReader) |
De asynchrone versie van WriteToServer(IDataReader), waarmee alle rijen in de opgegeven naar een doeltabel worden gekopieerd IDataReader die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. |
| WriteToServerAsync(DbDataReader, CancellationToken) |
De asynchrone versie van WriteToServer(DbDataReader), waarmee alle rijen van de opgegeven DbDataReader matrix worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. |
| WriteToServerAsync(DataRow[], CancellationToken) |
De asynchrone versie van WriteToServer(DataRow[]), waarmee alle rijen van de opgegeven DataRow matrix worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject. |
| WriteToServerAsync(DataTable, DataRowState) |
De asynchrone versie van WriteToServer(DataTable, DataRowState), waarmee alleen rijen worden gekopieerd die overeenkomen met de opgegeven rijstatus in de opgegeven DataTable doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. |
| WriteToServerAsync(DataTable, CancellationToken) |
De asynchrone versie van WriteToServer(DataTable), waarmee alle rijen in de opgegeven naar een doeltabel worden gekopieerd DataTable die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject. |
| WriteToServerAsync(DataTable, DataRowState, CancellationToken) |
De asynchrone versie van WriteToServer(DataTable, DataRowState), waarmee alleen rijen worden gekopieerd die overeenkomen met de opgegeven rijstatus in de opgegeven DataTable doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object. Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject. |
Opmerkingen
Als meerdere actieve resultatensets (MARS) zijn uitgeschakeld, WriteToServer wordt de verbinding bezet. Als MARS is ingeschakeld, kunt u aanroepen tussen WriteToServer elkaar opslaan met andere opdrachten in dezelfde verbinding.
Het aantal rijen dat wordt teruggedraaid wanneer één mislukt, is afhankelijk van verschillende dingen:
Als UseInternalTransaction dit is opgegeven.
Als u uw eigen transactie hebt.
De waarde van BatchSize.
Wanneer er een fout optreedt tijdens het verzenden van gegevens naar de server, wordt de huidige batch (zoals opgegeven door BatchSize) teruggedraaid. Als UseInternalTransaction dit niet is opgegeven en u uw eigen transactie hebt, wordt de hele transactie teruggedraaid (inclusief alle vorige batches).
Gebruik SqlRowsCopied dit om te weten hoeveel rijen naar de server zijn gekopieerd.
WriteToServerAsync(IDataReader, CancellationToken)
De asynchrone versie van WriteToServer(IDataReader), waarmee alle rijen in de opgegeven naar een doeltabel worden gekopieerd IDataReader die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
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 TaskParameters
- reader
- IDataReader
Een IDataReader waarvan de rijen worden gekopieerd naar de doeltabel.
- cancellationToken
- CancellationToken
De annuleringsinstructie. Een None waarde in deze parameter maakt deze methode gelijk aan WriteToServerAsync(DataTable).
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meerdere keren aanroepen WriteToServerAsync(IDataReader) voor hetzelfde exemplaar voordat de taak is voltooid.
Aanroepen WriteToServerAsync(IDataReader) en WriteToServer(IDataReader) voor hetzelfde exemplaar voordat de taak is voltooid.
De verbinding wordt verbroken of wordt gesloten tijdens WriteToServerAsync(IDataReader) de uitvoering.
Geretourneerd in het taakobject, werd het SqlBulkCopy object gesloten tijdens de uitvoering van de methode.
Er is een time-out voor de verbindingsgroep geretourneerd in het taakobject.
Geretourneerd in het taakobject, wordt het object gesloten voordat de SqlConnection methode wordt uitgevoerd.
De IDataReader is gesloten voordat de voltooide Task bewerking werd geretourneerd.
De IDataReadergekoppelde verbinding is gesloten voordat de voltooide Task verbinding is geretourneerd.
Context Connection=true is opgegeven in de verbindingsreeks.
Geretourneerd in het taakobject, elke fout die wordt geretourneerd door SQL Server die is opgetreden tijdens het openen van de verbinding.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(IDataReader)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(DbDataReader)
De asynchrone versie van WriteToServer(DbDataReader), waarmee alle rijen van de opgegeven DbDataReader matrix worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
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 TaskParameters
- reader
- DbDataReader
Een DbDataReader waarvan de rijen worden gekopieerd naar de doeltabel.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(DbDataReader)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(DataRow[])
De asynchrone versie van WriteToServer(DataRow[]), waarmee alle rijen van de opgegeven DataRow matrix worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
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 TaskParameters
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meerdere keren aanroepen WriteToServerAsync(DataRow[]) voor hetzelfde exemplaar voordat de taak is voltooid.
Aanroepen WriteToServerAsync(DataRow[]) en WriteToServer(DataRow[]) voor hetzelfde exemplaar voordat de taak is voltooid.
De verbinding wordt verbroken of wordt gesloten tijdens WriteToServerAsync(DataRow[]) de uitvoering.
Geretourneerd in het taakobject, werd het SqlBulkCopy object gesloten tijdens de uitvoering van de methode.
Er is een time-out voor de verbindingsgroep geretourneerd in het taakobject.
Geretourneerd in het taakobject, wordt het object gesloten voordat de SqlConnection methode wordt uitgevoerd.
Context Connection=true is opgegeven in de verbindingsreeks.
Geretourneerd in het taakobject, elke fout die wordt geretourneerd door SQL Server die is opgetreden tijdens het openen van de verbinding.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(DataRow[])de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(DataTable)
De asynchrone versie van WriteToServer(DataTable), waarmee alle rijen in de opgegeven naar een doeltabel worden gekopieerd DataTable die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
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 TaskParameters
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meerdere keren aanroepen WriteToServerAsync(DataTable) voor hetzelfde exemplaar voordat de taak is voltooid.
Aanroepen WriteToServerAsync(DataTable) en WriteToServer(DataTable) voor hetzelfde exemplaar voordat de taak is voltooid.
De verbinding wordt verbroken of wordt gesloten tijdens WriteToServerAsync(DataTable) de uitvoering.
Geretourneerd in het taakobject, werd het SqlBulkCopy object gesloten tijdens de uitvoering van de methode.
Er is een time-out voor de verbindingsgroep geretourneerd in het taakobject.
Geretourneerd in het taakobject, wordt het object gesloten voordat de SqlConnection methode wordt uitgevoerd.
Context Connection=true is opgegeven in de verbindingsreeks.
Geretourneerd in het taakobject, elke fout die wordt geretourneerd door SQL Server die is opgetreden tijdens het openen van de verbinding.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(DataTable)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(IDataReader)
De asynchrone versie van WriteToServer(IDataReader), waarmee alle rijen in de opgegeven naar een doeltabel worden gekopieerd IDataReader die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
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 TaskParameters
- reader
- IDataReader
Een IDataReader waarvan de rijen worden gekopieerd naar de doeltabel.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meerdere keren aanroepen WriteToServerAsync(IDataReader) voor hetzelfde exemplaar voordat de taak is voltooid.
Aanroepen WriteToServerAsync(IDataReader) en WriteToServer(IDataReader) voor hetzelfde exemplaar voordat de taak is voltooid.
De verbinding wordt verbroken of wordt gesloten tijdens WriteToServerAsync(IDataReader) de uitvoering.
Geretourneerd in het taakobject, werd het SqlBulkCopy object gesloten tijdens de uitvoering van de methode.
Er is een time-out voor de verbindingsgroep geretourneerd in het taakobject.
Geretourneerd in het taakobject, wordt het object gesloten voordat de SqlConnection methode wordt uitgevoerd.
De IDataReader is gesloten voordat de voltooide Task bewerking werd geretourneerd.
De IDataReadergekoppelde verbinding is gesloten voordat de voltooide Task verbinding is geretourneerd.
Context Connection=true is opgegeven in de verbindingsreeks.
Geretourneerd in het taakobject, elke fout die wordt geretourneerd door SQL Server die is opgetreden tijdens het openen van de verbinding.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(IDataReader)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(DbDataReader, CancellationToken)
De asynchrone versie van WriteToServer(DbDataReader), waarmee alle rijen van de opgegeven DbDataReader matrix worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
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 TaskParameters
- reader
- DbDataReader
Een DbDataReader waarvan de rijen worden gekopieerd naar de doeltabel.
- cancellationToken
- CancellationToken
De annuleringsinstructie. Een None waarde in deze parameter maakt deze methode gelijk aan WriteToServerAsync(DbDataReader).
Retouren
Retourneert Task.
Uitzonderingen
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(DbDataReader)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(DataRow[], CancellationToken)
De asynchrone versie van WriteToServer(DataRow[]), waarmee alle rijen van de opgegeven DataRow matrix worden gekopieerd naar een doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
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 TaskParameters
- cancellationToken
- CancellationToken
De annuleringsinstructie. Een None waarde in deze parameter maakt deze methode gelijk aan WriteToServerAsync(DataTable).
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meerdere keren aanroepen WriteToServerAsync(DataRow[]) voor hetzelfde exemplaar voordat de taak is voltooid.
Aanroepen WriteToServerAsync(DataRow[]) en WriteToServer(DataRow[]) voor hetzelfde exemplaar voordat de taak is voltooid.
De verbinding wordt verbroken of wordt gesloten tijdens WriteToServerAsync(DataRow[]) de uitvoering.
Geretourneerd in het taakobject, werd het SqlBulkCopy object gesloten tijdens de uitvoering van de methode.
Er is een time-out voor de verbindingsgroep geretourneerd in het taakobject.
Geretourneerd in het taakobject, wordt het object gesloten voordat de SqlConnection methode wordt uitgevoerd.
Context Connection=true is opgegeven in de verbindingsreeks.
Geretourneerd in het taakobject, elke fout die wordt geretourneerd door SQL Server die is opgetreden tijdens het openen van de verbinding.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(DataRow[])de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(DataTable, DataRowState)
De asynchrone versie van WriteToServer(DataTable, DataRowState), waarmee alleen rijen worden gekopieerd die overeenkomen met de opgegeven rijstatus in de opgegeven DataTable doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
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 TaskParameters
- rowState
- DataRowState
Een waarde uit de DataRowState opsomming. Alleen rijen die overeenkomen met de rijstatus worden gekopieerd naar het doel.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meerdere keren aanroepen WriteToServerAsync(DataTable, DataRowState) voor hetzelfde exemplaar voordat de taak is voltooid.
Aanroepen WriteToServerAsync(DataTable, DataRowState) en WriteToServer(DataTable, DataRowState) voor hetzelfde exemplaar voordat de taak is voltooid.
De verbinding wordt verbroken of wordt gesloten tijdens WriteToServerAsync(DataTable, DataRowState) de uitvoering.
Geretourneerd in het taakobject, werd het SqlBulkCopy object gesloten tijdens de uitvoering van de methode.
Er is een time-out voor de verbindingsgroep geretourneerd in het taakobject.
Geretourneerd in het taakobject, wordt het object gesloten voordat de SqlConnection methode wordt uitgevoerd.
Context Connection=true is opgegeven in de verbindingsreeks.
Geretourneerd in het taakobject, elke fout die wordt geretourneerd door SQL Server die is opgetreden tijdens het openen van de verbinding.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(DataTable, DataRowState)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(DataTable, CancellationToken)
De asynchrone versie van WriteToServer(DataTable), waarmee alle rijen in de opgegeven naar een doeltabel worden gekopieerd DataTable die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
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 TaskParameters
- cancellationToken
- CancellationToken
De annuleringsinstructie. Een None waarde in deze parameter maakt deze methode gelijk aan WriteToServerAsync(DataTable).
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meerdere keren aanroepen WriteToServerAsync(DataTable) voor hetzelfde exemplaar voordat de taak is voltooid.
Aanroepen WriteToServerAsync(DataTable) en WriteToServer(DataTable) voor hetzelfde exemplaar voordat de taak is voltooid.
De verbinding wordt verbroken of wordt gesloten tijdens WriteToServerAsync(DataTable) de uitvoering.
Geretourneerd in het taakobject, werd het SqlBulkCopy object gesloten tijdens de uitvoering van de methode.
Er is een time-out voor de verbindingsgroep geretourneerd in het taakobject.
Geretourneerd in het taakobject, wordt het object gesloten voordat de SqlConnection methode wordt uitgevoerd.
Context Connection=true is opgegeven in de verbindingsreeks.
Geretourneerd in het taakobject, elke fout die wordt geretourneerd door SQL Server die is opgetreden tijdens het openen van de verbinding.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(DataTable)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
WriteToServerAsync(DataTable, DataRowState, CancellationToken)
De asynchrone versie van WriteToServer(DataTable, DataRowState), waarmee alleen rijen worden gekopieerd die overeenkomen met de opgegeven rijstatus in de opgegeven DataTable doeltabel die is opgegeven door de DestinationTableName eigenschap van het SqlBulkCopy object.
Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
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 TaskParameters
- rowState
- DataRowState
Een waarde uit de DataRowState opsomming. Alleen rijen die overeenkomen met de rijstatus worden gekopieerd naar het doel.
- cancellationToken
- CancellationToken
De annuleringsinstructie. Een None waarde in deze parameter maakt deze methode gelijk aan WriteToServerAsync(DataTable).
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meerdere keren aanroepen WriteToServerAsync(DataTable, DataRowState) voor hetzelfde exemplaar voordat de taak is voltooid.
Aanroepen WriteToServerAsync(DataTable, DataRowState) en WriteToServer(DataTable, DataRowState) voor hetzelfde exemplaar voordat de taak is voltooid.
De verbinding wordt verbroken of wordt gesloten tijdens WriteToServerAsync(DataTable, DataRowState) de uitvoering.
Geretourneerd in het taakobject, werd het SqlBulkCopy object gesloten tijdens de uitvoering van de methode.
Er is een time-out voor de verbindingsgroep geretourneerd in het taakobject.
Geretourneerd in het taakobject, wordt het object gesloten voordat de SqlConnection methode wordt uitgevoerd.
Context Connection=true is opgegeven in de verbindingsreeks.
Geretourneerd in het taakobject, elke fout die wordt geretourneerd door SQL Server die is opgetreden tijdens het openen van de verbinding.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteToServer(DataTable, DataRowState)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.