SqlBulkCopy.WriteToServerAsync Methode

Definition

Die asynchrone Version von WriteToServer, mit der alle Zeilen aus einer Datenquelle in eine Zieltabelle kopiert werden, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.An asynchronous version of WriteToServer, which copies all rows from a data source to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Überlädt

WriteToServerAsync(IDataReader, CancellationToken)

Eine asynchrone Version von WriteToServer(IDataReader), die alle Zeilen in das bereitgestellte IDataReader-Array in eine Zieltabelle kopiert, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.The asynchronous version of WriteToServer(IDataReader), which copies all rows in the supplied IDataReader to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

WriteToServerAsync(DbDataReader)

Eine asynchrone Version von WriteToServer(DbDataReader), die alle Zeilen aus dem bereitgestellten DbDataReader-Array in eine Zieltabelle kopiert, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.The asynchronous version of WriteToServer(DbDataReader), which copies all rows from the supplied DbDataReader array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DataRow[])

Die asynchrone Version von WriteToServer(DataRow[]), mit der alle Zeilen aus dem bereitgestellten DataRow-Array in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DataRow[]), which copies all rows from the supplied DataRow array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DataTable)

Die asynchrone Version von WriteToServer(DataTable), mit der alle Zeilen im bereitgestellten DataTable in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DataTable), which copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(IDataReader)

Die asynchrone Version von WriteToServer(IDataReader), mit der alle Zeilen im bereitgestellten IDataReader in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(IDataReader), which copies all rows in the supplied IDataReader to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DbDataReader, CancellationToken)

Die asynchrone Version von WriteToServer(DbDataReader), mit der alle Zeilen aus dem bereitgestellten DbDataReader-Array in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DbDataReader), which copies all rows from the supplied DbDataReader array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DataRow[], CancellationToken)

Die asynchrone Version von WriteToServer(DataRow[]), mit der alle Zeilen aus dem bereitgestellten DataRow-Array in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DataRow[]), which copies all rows from the supplied DataRow array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

WriteToServerAsync(DataTable, DataRowState)

Die asynchrone Version von WriteToServer(DataTable, DataRowState), die nur die Zeilen mit dem angegebenen Zeilenzustand aus der bereitgestellten DataTable in eine Zieltabelle kopiert, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.The asynchronous version of WriteToServer(DataTable, DataRowState), which copies only rows that match the supplied row state in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DataTable, CancellationToken)

Eine asynchrone Version von WriteToServer(DataTable), die alle Zeilen in das bereitgestellte DataTable-Array in eine Zieltabelle kopiert, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.The asynchronous version of WriteToServer(DataTable), which copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Die asynchrone Version von WriteToServer(DataTable, DataRowState), die nur die Zeilen, die dem angegebenen Zeilenstatus in der bereitgestellten DataTable entsprechen, in eine Zieltabelle kopiert, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DataTable, DataRowState), which copies only rows that match the supplied row state in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

Hinweise

Wenn Mars (Multiple Active Result Sets) deaktiviert ist, macht WriteToServer die Verbindung ausgelastet.If multiple active result sets (MARS) is disabled, WriteToServer makes the connection busy. Wenn MARS aktiviert ist, können Sie Aufrufe an WriteToServer mit anderen Befehlen in derselben Verbindung überlassen.If MARS is enabled, you can interleave calls to WriteToServer with other commands in the same connection.

Die Anzahl der Zeilen, für die bei einem Fehler ein Rollback ausgeführt wird, hängt von mehreren Faktoren ab:The number of rows that are rolled back when one fails depends on several things:

Wenn beim Senden von Daten an den Server ein Fehler auftritt, wird für den aktuellen Batch (wie von BatchSize angegeben) ein Rollback ausgeführt.When there is an error while sending data to the server, the current batch (as specified by BatchSize) will be rolled back. Wenn UseInternalTransaction nicht angegeben ist und Sie über eine eigene Transaktion verfügen, wird für die gesamte Transaktion ein Rollback ausgeführt (was auch alle vorherigen Batches einschließt).If UseInternalTransaction is not specified and you have your own transaction, the entire transaction will be rolled back (which includes all previous batches as well).

Verwenden Sie SqlRowsCopied, um zu ermitteln, wie viele Zeilen auf den Server kopiert wurden.Use SqlRowsCopied to know how many rows were copied to the server.

WriteToServerAsync(IDataReader, CancellationToken)

Eine asynchrone Version von WriteToServer(IDataReader), die alle Zeilen in das bereitgestellte IDataReader-Array in eine Zieltabelle kopiert, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.The asynchronous version of WriteToServer(IDataReader), which copies all rows in the supplied IDataReader to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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

Parameter

reader
IDataReader

Ein IDataReader-Objekt, dessen Zeilen in die Zieltabelle kopiert werden.A IDataReader whose rows will be copied to the destination table.

cancellationToken
CancellationToken

Die Abbruchanweisung.The cancellation instruction. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DataTable).A None value in this parameter makes this method equivalent to WriteToServerAsync(DataTable).

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

WriteToServerAsync(IDataReader) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.Calling WriteToServerAsync(IDataReader) multiple times for the same instance before task completion.

Aufruf von WriteToServerAsync(IDataReader) und WriteToServer(IDataReader) für die gleiche Instanz vor Aufgabenabschluss.Calling WriteToServerAsync(IDataReader) and WriteToServer(IDataReader) for the same instance before task completion.

Die Verbindung geht verloren oder wird während WriteToServerAsync(IDataReader)-Ausführung beendet.The connection drops or is closed during WriteToServerAsync(IDataReader) execution.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.Returned in the task object, there was a connection pool timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.Returned in the task object, the SqlConnection object is closed before method execution.

Der IDataReader wurde geschlossen, bevor die abgeschlossene Task zurückgegeben wurde.The IDataReader was closed before the completed Task returned.

Die zugeordnete Verbindung für den IDataReader wurde geschlossen, bevor die abgeschlossene Task zurückgegeben wurde.The IDataReader's associated connection was closed before the completed Task returned.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DbDataReader)

Eine asynchrone Version von WriteToServer(DbDataReader), die alle Zeilen aus dem bereitgestellten DbDataReader-Array in eine Zieltabelle kopiert, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.The asynchronous version of WriteToServer(DbDataReader), which copies all rows from the supplied DbDataReader array to a destination table specified by the DestinationTableName property of the 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.Task
Public Function WriteToServerAsync (reader As DbDataReader) As Task

Parameter

reader
DbDataReader

Ein DbDataReader-Objekt, dessen Zeilen in die Zieltabelle kopiert werden.A DbDataReader whose rows will be copied to the destination table.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

WriteToServerAsync(DataRow[])

Die asynchrone Version von WriteToServer(DataRow[]), mit der alle Zeilen aus dem bereitgestellten DataRow-Array in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DataRow[]), which copies all rows from the supplied DataRow array to a destination table specified by the DestinationTableName property of the 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.Task
Public Function WriteToServerAsync (rows As DataRow()) As Task

Parameter

rows
DataRow[]

Ein Array von DataRow-Objekten, die in die Zieltabelle kopiert werden.An array of DataRow objects that will be copied to the destination table.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

WriteToServerAsync(DataRow[]) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.Calling WriteToServerAsync(DataRow[]) multiple times for the same instance before task completion.

Aufruf von WriteToServerAsync(DataRow[]) und WriteToServer(DataRow[]) für die gleiche Instanz vor Aufgabenabschluss.Calling WriteToServerAsync(DataRow[]) and WriteToServer(DataRow[]) for the same instance before task completion.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataRow[])-Ausführung beendet.The connection drops or is closed during WriteToServerAsync(DataRow[]) execution.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.Returned in the task object, there was a connection pool timeout.

Das im Aufgabenobjekt zurückgegebene SqlConnection-Objekt wurde vor der Methodenausführung geschlossen.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DataTable)

Die asynchrone Version von WriteToServer(DataTable), mit der alle Zeilen im bereitgestellten DataTable in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DataTable), which copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the 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.Task
Public Function WriteToServerAsync (table As DataTable) As Task

Parameter

table
DataTable

Ein DataTable-Objekt, dessen Zeilen in die Zieltabelle kopiert werden.A DataTable whose rows will be copied to the destination table.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

WriteToServerAsync(DataTable) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.Calling WriteToServerAsync(DataTable) multiple times for the same instance before task completion.

Aufruf von WriteToServerAsync(DataTable) und WriteToServer(DataTable) für die gleiche Instanz vor Aufgabenabschluss.Calling WriteToServerAsync(DataTable) and WriteToServer(DataTable) for the same instance before task completion.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataTable)-Ausführung beendet.The connection drops or is closed during WriteToServerAsync(DataTable) execution.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.Returned in the task object, there was a connection pool timeout.

Das im Aufgabenobjekt zurückgegebene SqlConnection-Objekt wurde vor der Methodenausführung geschlossen.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(IDataReader)

Die asynchrone Version von WriteToServer(IDataReader), mit der alle Zeilen im bereitgestellten IDataReader in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(IDataReader), which copies all rows in the supplied IDataReader to a destination table specified by the DestinationTableName property of the 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.Task
Public Function WriteToServerAsync (reader As IDataReader) As Task

Parameter

reader
IDataReader

Ein IDataReader-Objekt, dessen Zeilen in die Zieltabelle kopiert werden.A IDataReader whose rows will be copied to the destination table.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

WriteToServerAsync(IDataReader) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.Calling WriteToServerAsync(IDataReader) multiple times for the same instance before task completion.

Aufruf von WriteToServerAsync(IDataReader) und WriteToServer(IDataReader) für die gleiche Instanz vor Aufgabenabschluss.Calling WriteToServerAsync(IDataReader) and WriteToServer(IDataReader) for the same instance before task completion.

Die Verbindung geht verloren oder wird während WriteToServerAsync(IDataReader)-Ausführung beendet.The connection drops or is closed during WriteToServerAsync(IDataReader) execution.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.Returned in the task object, there was a connection pool timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.Returned in the task object, the SqlConnection object is closed before method execution.

Der IDataReader wurde geschlossen, bevor die abgeschlossene Task zurückgegeben wurde.The IDataReader was closed before the completed Task returned.

Die zugeordnete Verbindung für den IDataReader wurde geschlossen, bevor die abgeschlossene Task zurückgegeben wurde.The IDataReader's associated connection was closed before the completed Task returned.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DbDataReader, CancellationToken)

Die asynchrone Version von WriteToServer(DbDataReader), mit der alle Zeilen aus dem bereitgestellten DbDataReader-Array in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DbDataReader), which copies all rows from the supplied DbDataReader array to a destination table specified by the DestinationTableName property of the 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.Task

Parameter

reader
DbDataReader

Ein DbDataReader-Objekt, dessen Zeilen in die Zieltabelle kopiert werden.A DbDataReader whose rows will be copied to the destination table.

cancellationToken
CancellationToken

Die Abbruchanweisung.The cancellation instruction. Ein None-Wert in diesem Parameter bewirkt, dass diese Methode mit WriteToServerAsync(DbDataReader) identisch ist.A None value in this parameter makes this method equivalent to WriteToServerAsync(DbDataReader).

Gibt zurück

Gibt Task zurück.Returns Task.

WriteToServerAsync(DataRow[], CancellationToken)

Die asynchrone Version von WriteToServer(DataRow[]), mit der alle Zeilen aus dem bereitgestellten DataRow-Array in eine Zieltabelle kopiert werden, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DataRow[]), which copies all rows from the supplied DataRow array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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

Parameter

rows
DataRow[]

Ein Array von DataRow-Objekten, die in die Zieltabelle kopiert werden.An array of DataRow objects that will be copied to the destination table.

cancellationToken
CancellationToken

Die Abbruchanweisung.The cancellation instruction. Ein None-Wert in diesem Parameter bewirkt, dass diese Methode mit WriteToServerAsync(DataTable) identisch ist.A None value in this parameter makes this method equivalent to WriteToServerAsync(DataTable).

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

WriteToServerAsync(DataRow[]) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.Calling WriteToServerAsync(DataRow[]) multiple times for the same instance before task completion.

Aufruf von WriteToServerAsync(DataRow[]) und WriteToServer(DataRow[]) für die gleiche Instanz vor Aufgabenabschluss.Calling WriteToServerAsync(DataRow[]) and WriteToServer(DataRow[]) for the same instance before task completion.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataRow[])-Ausführung beendet.The connection drops or is closed during WriteToServerAsync(DataRow[]) execution.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.Returned in the task object, there was a connection pool timeout.

Das im Aufgabenobjekt zurückgegebene SqlConnection-Objekt wurde vor der Methodenausführung geschlossen.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DataTable, DataRowState)

Die asynchrone Version von WriteToServer(DataTable, DataRowState), die nur die Zeilen mit dem angegebenen Zeilenzustand aus der bereitgestellten DataTable in eine Zieltabelle kopiert, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.The asynchronous version of WriteToServer(DataTable, DataRowState), which copies only rows that match the supplied row state in the supplied DataTable to a destination table specified by the DestinationTableName property of the 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.Task
Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As Task

Parameter

table
DataTable

Ein DataTable, deren Zeilen in die Zieltabelle kopiert werden.A DataTable whose rows will be copied to the destination table.

rowState
DataRowState

Ein Wert aus der DataRowState-Enumeration.A value from the DataRowState enumeration. Nur Zeilen, die dem Zeilenstatus entsprechen, werden in die Zieltabelle kopiert.Only rows matching the row state are copied to the destination.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

WriteToServerAsync(DataTable, DataRowState) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.Calling WriteToServerAsync(DataTable, DataRowState) multiple times for the same instance before task completion.

Aufruf von WriteToServerAsync(DataTable, DataRowState) und WriteToServer(DataTable, DataRowState) für die gleiche Instanz vor Aufgabenabschluss.Calling WriteToServerAsync(DataTable, DataRowState) and WriteToServer(DataTable, DataRowState) for the same instance before task completion.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataTable, DataRowState)-Ausführung beendet.The connection drops or is closed during WriteToServerAsync(DataTable, DataRowState) execution.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.Returned in the task object, there was a connection pool timeout.

Das im Aufgabenobjekt zurückgegebene SqlConnection-Objekt wurde vor der Methodenausführung geschlossen.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DataTable, CancellationToken)

Eine asynchrone Version von WriteToServer(DataTable), die alle Zeilen in das bereitgestellte DataTable-Array in eine Zieltabelle kopiert, die von der DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben wird.The asynchronous version of WriteToServer(DataTable), which copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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

Parameter

table
DataTable

Ein DataTable-Objekt, dessen Zeilen in die Zieltabelle kopiert werden.A DataTable whose rows will be copied to the destination table.

cancellationToken
CancellationToken

Die Abbruchanweisung.The cancellation instruction. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DataTable).A None value in this parameter makes this method equivalent to WriteToServerAsync(DataTable).

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

WriteToServerAsync(DataTable) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.Calling WriteToServerAsync(DataTable) multiple times for the same instance before task completion.

Aufruf von WriteToServerAsync(DataTable) und WriteToServer(DataTable) für die gleiche Instanz vor Aufgabenabschluss.Calling WriteToServerAsync(DataTable) and WriteToServer(DataTable) for the same instance before task completion.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataTable)-Ausführung beendet.The connection drops or is closed during WriteToServerAsync(DataTable) execution.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.Returned in the task object, there was a connection pool timeout.

Das im Aufgabenobjekt zurückgegebene SqlConnection-Objekt wurde vor der Methodenausführung geschlossen.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Die asynchrone Version von WriteToServer(DataTable, DataRowState), die nur die Zeilen, die dem angegebenen Zeilenstatus in der bereitgestellten DataTable entsprechen, in eine Zieltabelle kopiert, die durch die DestinationTableName-Eigenschaft des SqlBulkCopy-Objekts angegeben ist.The asynchronous version of WriteToServer(DataTable, DataRowState), which copies only rows that match the supplied row state in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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

Parameter

table
DataTable

Ein DataTable, deren Zeilen in die Zieltabelle kopiert werden.A DataTable whose rows will be copied to the destination table.

rowState
DataRowState

Ein Wert aus der DataRowState-Enumeration.A value from the DataRowState enumeration. Es werden nur die Zeilen mit dem entsprechenden Zeilenzustand ins Ziel kopiert.Only rows matching the row state are copied to the destination.

cancellationToken
CancellationToken

Die Abbruchanweisung.The cancellation instruction. Ein None-Wert in diesem Parameter bewirkt, dass diese Methode mit WriteToServerAsync(DataTable) identisch ist.A None value in this parameter makes this method equivalent to WriteToServerAsync(DataTable).

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

WriteToServerAsync(DataTable, DataRowState) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.Calling WriteToServerAsync(DataTable, DataRowState) multiple times for the same instance before task completion.

Aufruf von WriteToServerAsync(DataTable, DataRowState) und WriteToServer(DataTable, DataRowState) für die gleiche Instanz vor Aufgabenabschluss.Calling WriteToServerAsync(DataTable, DataRowState) and WriteToServer(DataTable, DataRowState) for the same instance before task completion.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataTable, DataRowState)-Ausführung beendet.The connection drops or is closed during WriteToServerAsync(DataTable, DataRowState) execution.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.Returned in the task object, there was a connection pool timeout.

Das im Aufgabenobjekt zurückgegebene SqlConnection-Objekt wurde vor der Methodenausführung geschlossen.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Gilt für: