SqlBulkCopy.WriteToServerAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 verschachteln.
Die Anzahl der Zeilen, die bei einem Fehler zurückgesetzt werden, hängt von mehreren Dingen 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.TaskPublic Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As TaskParameter
- 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
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
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.
Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.
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 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteToServer(IDataReader).
Gilt für:
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader) As TaskParameter
- reader
- DbDataReader
Ein DbDataReader, deren Zeilen in die Zieltabelle kopiert werden.
Gibt zurück
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 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteToServer(DbDataReader).
Gilt für:
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.TaskPublic Function WriteToServerAsync (rows As DataRow()) As TaskParameter
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
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.
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 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteToServer(DataRow[]).
Gilt für:
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.TaskPublic Function WriteToServerAsync (table As DataTable) As TaskParameter
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
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.
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 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten WriteToServer(DataTable)Ausnahmen.
Gilt für:
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.TaskPublic Function WriteToServerAsync (reader As IDataReader) As TaskParameter
- reader
- IDataReader
Ein IDataReader, deren Zeilen in die Zieltabelle kopiert werden.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
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.
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.
Gilt für:
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As TaskParameter
- 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
Gibt Task zurück.
Ausnahmen
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.
Gilt für:
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.TaskPublic Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As TaskParameter
- cancellationToken
- CancellationToken
Die Abbruchanweisung. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DataTable).
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
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.
Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.
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.
Gilt für:
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As TaskParameter
- rowState
- DataRowState
Ein Wert aus der DataRowState-Enumeration. Es werden nur die Zeilen mit dem entsprechenden Zeilenzustand ins Ziel kopiert.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
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.
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.
Gilt für:
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.TaskPublic Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As TaskParameter
- cancellationToken
- CancellationToken
Die Abbruchanweisung. Ein None-Wert in diesem Parameter macht diese Methode äquivalent zu WriteToServerAsync(DataTable).
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
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.
Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.
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.
Gilt für:
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As TaskParameter
- 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
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
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.
Bei Rückgabe im Aufgabenobjekt jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.
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 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteToServer(DataTable, DataRowState).
