SqlBulkCopy.WriteToServerAsync Methode

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

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.

Ü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. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.
WriteToServerAsync(DbDataReader)	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.
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.
WriteToServerAsync(DataTable)	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.
WriteToServerAsync(IDataReader)	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.
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.
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. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.
WriteToServerAsync(DataTable, DataRowState)	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.
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. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.
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. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

Hinweise

Wenn mehrere aktive Resultsets (MARS) deaktiviert sind, WriteToServer wird die Verbindung ausgelastet. Wenn MARS aktiviert ist, können Sie Aufrufe von WriteToServer mit anderen Befehlen in derselben Verbindung verweben.

Die Anzahl der Zeilen, die bei einem Fehler zurückgesetzt werden, hängt von mehreren Faktoren ab:

• Wenn UseInternalTransaction angegeben ist.

• Wenn Sie über eine eigene Transaktion verfügen.

• Der Wert von BatchSize.

Wenn beim Senden von Daten an den Server ein Fehler auftritt, wird für den aktuellen Batch (wie durch BatchSizeangegeben ) ein Rollback ausgeführt. Wenn UseInternalTransaction nicht angegeben ist und Sie über eine eigene Transaktion verfügen, wird ein Rollback für die gesamte Transaktion ausgeführt (einschließlich aller vorherigen Batches).

Verwenden Sie SqlRowsCopied , um zu ermitteln, wie viele Zeilen auf den Server kopiert wurden.

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.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

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

Parameter

reader

IDataReader

Ein IDataReader, deren Zeilen in die Zieltabelle kopiert werden.

cancellationToken

CancellationToken

Die Abbruchanweisung. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DataTable).

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

WriteToServerAsync(IDataReader) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.

Aufruf von WriteToServerAsync(IDataReader) und WriteToServer(IDataReader) für die gleiche Instanz vor Aufgabenabschluss.

Die Verbindung geht verloren oder wird während WriteToServerAsync(IDataReader)-Ausführung beendet.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.

Der IDataReader wurde geschlossen, bevor die abgeschlossene Task zurückgegeben wurde.

Die zugeordnete Verbindung für den IDataReader wurde geschlossen, bevor die abgeschlossene Task zurückgegeben wurde.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SqlException

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(IDataReader)Ausnahmen.

WriteToServerAsync(DbDataReader)

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.

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, deren Zeilen in die Zieltabelle kopiert werden.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DbDataReader)Ausnahmen.

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.

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.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

WriteToServerAsync(DataRow[]) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.

Aufruf von WriteToServerAsync(DataRow[]) und WriteToServer(DataRow[]) für die gleiche Instanz vor Aufgabenabschluss.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataRow[])-Ausführung beendet.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SqlException

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DataRow[])Ausnahmen.

WriteToServerAsync(DataTable)

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.

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, deren Zeilen in die Zieltabelle kopiert werden.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

WriteToServerAsync(DataTable) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.

Aufruf von WriteToServerAsync(DataTable) und WriteToServer(DataTable) für die gleiche Instanz vor Aufgabenabschluss.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataTable)-Ausführung beendet.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SqlException

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DataTable)Ausnahmen.

WriteToServerAsync(IDataReader)

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.

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, deren Zeilen in die Zieltabelle kopiert werden.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

WriteToServerAsync(IDataReader) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.

Aufruf von WriteToServerAsync(IDataReader) und WriteToServer(IDataReader) für die gleiche Instanz vor Aufgabenabschluss.

Die Verbindung geht verloren oder wird während WriteToServerAsync(IDataReader)-Ausführung beendet.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.

Der IDataReader wurde geschlossen, bevor die abgeschlossene Task zurückgegeben wurde.

Die zugeordnete Verbindung für den IDataReader wurde geschlossen, bevor die abgeschlossene Task zurückgegeben wurde.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SqlException

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(IDataReader)Ausnahmen.

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.

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

Parameter

reader

DbDataReader

Ein DbDataReader, deren Zeilen in die Zieltabelle kopiert werden.

cancellationToken

CancellationToken

Die Abbruchanweisung. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DbDataReader).

Gibt zurück

Task

Gibt Task zurück.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DbDataReader)Ausnahmen.

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.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

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

Parameter

rows

DataRow[]

Ein Array von DataRow-Objekten, die in die Zieltabelle kopiert werden.

cancellationToken

CancellationToken

Die Abbruchanweisung. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DataTable).

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

WriteToServerAsync(DataRow[]) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.

Aufruf von WriteToServerAsync(DataRow[]) und WriteToServer(DataRow[]) für die gleiche Instanz vor Aufgabenabschluss.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataRow[])-Ausführung beendet.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SqlException

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DataRow[])Ausnahmen.

WriteToServerAsync(DataTable, DataRowState)

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.

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.

rowState

DataRowState

Ein Wert aus der DataRowState-Enumeration. Es werden nur die Zeilen mit dem entsprechenden Zeilenzustand ins Ziel kopiert.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

WriteToServerAsync(DataTable, DataRowState) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.

Aufruf von WriteToServerAsync(DataTable, DataRowState) und WriteToServer(DataTable, DataRowState) für die gleiche Instanz vor Aufgabenabschluss.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataTable, DataRowState)-Ausführung beendet.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SqlException

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DataTable, DataRowState)Ausnahmen.

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.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

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

Parameter

table

DataTable

Ein DataTable, deren Zeilen in die Zieltabelle kopiert werden.

cancellationToken

CancellationToken

Die Abbruchanweisung. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DataTable).

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

WriteToServerAsync(DataTable) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.

Aufruf von WriteToServerAsync(DataTable) und WriteToServer(DataTable) für die gleiche Instanz vor Aufgabenabschluss.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataTable)-Ausführung beendet.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SqlException

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DataTable)Ausnahmen.

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.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

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

Parameter

table

DataTable

Ein DataTable, deren Zeilen in die Zieltabelle kopiert werden.

rowState

DataRowState

Ein Wert aus der DataRowState-Enumeration. Es werden nur die Zeilen mit dem entsprechenden Zeilenzustand ins Ziel kopiert.

cancellationToken

CancellationToken

Die Abbruchanweisung. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DataTable).

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

WriteToServerAsync(DataTable, DataRowState) wird mehrfach für dieselbe Instanz aufgerufen, bevor die Aufgabe abgeschlossen ist.

Aufruf von WriteToServerAsync(DataTable, DataRowState) und WriteToServer(DataTable, DataRowState) für die gleiche Instanz vor Aufgabenabschluss.

Die Verbindung geht verloren oder wird während WriteToServerAsync(DataTable, DataRowState)-Ausführung beendet.

Bei Rückgabe im Taskobjekt wurde das SqlBulkCopy-Objekt während der Methodenausführung geschlossen.

Bei Rückgabe im Taskobjekt ein Verbindungspool-Timeout.

Bei Rückgabe im Taskobjekt wird das SqlConnection-Objekt vor der Methodenausführung geschlossen.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SqlException

Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DataTable, DataRowState)Ausnahmen.