SqlBulkCopy.WriteToServerAsync Método

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.dll

Una versión asincrónica de WriteToServer, que copia todas las filas de un origen de datos a una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

Sobrecargas

Nombre	Description
WriteToServerAsync(IDataReader, CancellationToken)	La versión asincrónica de WriteToServer(IDataReader), que copia todas las filas de la tabla de destino proporcionadas IDataReader en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto . El token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se notificarán a través del objeto Task devuelto.
WriteToServerAsync(DbDataReader)	La versión asincrónica de WriteToServer(DbDataReader), que copia todas las filas de la matriz proporcionada DbDataReader en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .
WriteToServerAsync(DataRow[])	La versión asincrónica de WriteToServer(DataRow[]), que copia todas las filas de la matriz proporcionada DataRow en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .
WriteToServerAsync(DataTable)	La versión asincrónica de WriteToServer(DataTable), que copia todas las filas de la tabla de destino proporcionadas DataTable en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .
WriteToServerAsync(IDataReader)	La versión asincrónica de WriteToServer(IDataReader), que copia todas las filas de la tabla de destino proporcionadas IDataReader en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .
WriteToServerAsync(DbDataReader, CancellationToken)	La versión asincrónica de WriteToServer(DbDataReader), que copia todas las filas de la matriz proporcionada DbDataReader en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .
WriteToServerAsync(DataRow[], CancellationToken)	La versión asincrónica de WriteToServer(DataRow[]), que copia todas las filas de la matriz proporcionada DataRow en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto . El token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se notificarán a través del objeto Task devuelto.
WriteToServerAsync(DataTable, DataRowState)	La versión asincrónica de WriteToServer(DataTable, DataRowState), que copia solo las filas que coinciden con el estado de fila proporcionado en la tabla de DataTable destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .
WriteToServerAsync(DataTable, CancellationToken)	La versión asincrónica de WriteToServer(DataTable), que copia todas las filas de la tabla de destino proporcionadas DataTable en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto . El token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se notificarán a través del objeto Task devuelto.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	La versión asincrónica de WriteToServer(DataTable, DataRowState), que copia solo las filas que coinciden con el estado de fila proporcionado en la tabla de DataTable destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto . El token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se notificarán a través del objeto Task devuelto.

Comentarios

Si hay varios conjuntos de resultados activos (MARS) deshabilitados, WriteToServer la conexión está ocupada. Si MARS está habilitado, puede intercalar llamadas a WriteToServer con otros comandos en la misma conexión.

El número de filas que se revierten cuando se produce un error depende de varias cosas:

• Si UseInternalTransaction se especifica.

• Si tiene su propia transacción.

• El valor de BatchSize.

Cuando se produce un error al enviar datos al servidor, se revertirá el lote actual (según lo especificado por BatchSize). Si UseInternalTransaction no se especifica y tiene su propia transacción, toda la transacción se revertirá (lo que incluye también todos los lotes anteriores).

Use SqlRowsCopied para saber cuántas filas se copiaron en el servidor.

WriteToServerAsync(IDataReader, CancellationToken)

La versión asincrónica de WriteToServer(IDataReader), que copia todas las filas de la tabla de destino proporcionadas IDataReader en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

El token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se notificarán a través del objeto Task devuelto.

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

Parámetros

reader

IDataReader

cuyas IDataReader filas se copiarán en la tabla de destino.

cancellationToken

CancellationToken

Instrucción de cancelación. Un None valor de este parámetro hace que este método sea equivalente a WriteToServerAsync(DataTable).

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

Llamar a WriteToServerAsync(IDataReader) varias veces para la misma instancia antes de la finalización de la tarea.

Llamar a WriteToServerAsync(IDataReader) y WriteToServer(IDataReader) para la misma instancia antes de la finalización de la tarea.

La conexión quita o se cierra durante la WriteToServerAsync(IDataReader) ejecución.

Devuelto en el objeto de tarea, el SqlBulkCopy objeto se cerró durante la ejecución del método.

Se devolvió en el objeto de tarea, se ha agotado el tiempo de espera del grupo de conexiones.

Devuelto en el objeto de tarea, el SqlConnection objeto se cierra antes de la ejecución del método.

IDataReader se cerró antes de que se devolvió la finalizaciónTask.

La IDataReaderconexión asociada se cerró antes de que se devolvió la finalización Task .

Context Connection=true se especifica en el cadena de conexión.

SqlException

Se devuelve en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader)

La versión asincrónica de WriteToServer(DbDataReader), que copia todas las filas de la matriz proporcionada DbDataReader en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

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

Parámetros

reader

DbDataReader

cuyas DbDataReader filas se copiarán en la tabla de destino.

Devoluciones

Task

Tarea que representa la operación asincrónica.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DbDataReader).

WriteToServerAsync(DataRow[])

La versión asincrónica de WriteToServer(DataRow[]), que copia todas las filas de la matriz proporcionada DataRow en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

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

Parámetros

rows

DataRow[]

Matriz de DataRow objetos que se copiarán en la tabla de destino.

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

Llamar a WriteToServerAsync(DataRow[]) varias veces para la misma instancia antes de la finalización de la tarea.

Llamar a WriteToServerAsync(DataRow[]) y WriteToServer(DataRow[]) para la misma instancia antes de la finalización de la tarea.

La conexión quita o se cierra durante la WriteToServerAsync(DataRow[]) ejecución.

Devuelto en el objeto de tarea, el SqlBulkCopy objeto se cerró durante la ejecución del método.

Se devolvió en el objeto de tarea, se ha agotado el tiempo de espera del grupo de conexiones.

Devuelto en el objeto de tarea, el SqlConnection objeto se cierra antes de la ejecución del método.

Context Connection=true se especifica en el cadena de conexión.

SqlException

Se devuelve en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DataRow[]).

WriteToServerAsync(DataTable)

La versión asincrónica de WriteToServer(DataTable), que copia todas las filas de la tabla de destino proporcionadas DataTable en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

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

Parámetros

table

DataTable

cuyas DataTable filas se copiarán en la tabla de destino.

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

Llamar a WriteToServerAsync(DataTable) varias veces para la misma instancia antes de la finalización de la tarea.

Llamar a WriteToServerAsync(DataTable) y WriteToServer(DataTable) para la misma instancia antes de la finalización de la tarea.

La conexión quita o se cierra durante la WriteToServerAsync(DataTable) ejecución.

Devuelto en el objeto de tarea, el SqlBulkCopy objeto se cerró durante la ejecución del método.

Se devolvió en el objeto de tarea, se ha agotado el tiempo de espera del grupo de conexiones.

Devuelto en el objeto de tarea, el SqlConnection objeto se cierra antes de la ejecución del método.

Context Connection=true se especifica en el cadena de conexión.

SqlException

Se devuelve en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DataTable).

WriteToServerAsync(IDataReader)

La versión asincrónica de WriteToServer(IDataReader), que copia todas las filas de la tabla de destino proporcionadas IDataReader en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

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

Parámetros

reader

IDataReader

cuyas IDataReader filas se copiarán en la tabla de destino.

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

Llamar a WriteToServerAsync(IDataReader) varias veces para la misma instancia antes de la finalización de la tarea.

Llamar a WriteToServerAsync(IDataReader) y WriteToServer(IDataReader) para la misma instancia antes de la finalización de la tarea.

La conexión quita o se cierra durante la WriteToServerAsync(IDataReader) ejecución.

Devuelto en el objeto de tarea, el SqlBulkCopy objeto se cerró durante la ejecución del método.

Se devolvió en el objeto de tarea, se ha agotado el tiempo de espera del grupo de conexiones.

Devuelto en el objeto de tarea, el SqlConnection objeto se cierra antes de la ejecución del método.

IDataReader se cerró antes de que se devolvió la finalizaciónTask.

La IDataReaderconexión asociada se cerró antes de que se devolvió la finalización Task .

Context Connection=true se especifica en el cadena de conexión.

SqlException

Se devuelve en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader, CancellationToken)

La versión asincrónica de WriteToServer(DbDataReader), que copia todas las filas de la matriz proporcionada DbDataReader en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

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

Parámetros

reader

DbDataReader

cuyas DbDataReader filas se copiarán en la tabla de destino.

cancellationToken

CancellationToken

Instrucción de cancelación. Un None valor de este parámetro hace que este método sea equivalente a WriteToServerAsync(DbDataReader).

Devoluciones

Task

Devuelve Task.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DbDataReader).

WriteToServerAsync(DataRow[], CancellationToken)

La versión asincrónica de WriteToServer(DataRow[]), que copia todas las filas de la matriz proporcionada DataRow en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

El token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se notificarán a través del objeto Task devuelto.

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

Parámetros

rows

DataRow[]

Matriz de DataRow objetos que se copiarán en la tabla de destino.

cancellationToken

CancellationToken

Instrucción de cancelación. Un None valor de este parámetro hace que este método sea equivalente a WriteToServerAsync(DataTable).

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

Llamar a WriteToServerAsync(DataRow[]) varias veces para la misma instancia antes de la finalización de la tarea.

Llamar a WriteToServerAsync(DataRow[]) y WriteToServer(DataRow[]) para la misma instancia antes de la finalización de la tarea.

La conexión quita o se cierra durante la WriteToServerAsync(DataRow[]) ejecución.

Devuelto en el objeto de tarea, el SqlBulkCopy objeto se cerró durante la ejecución del método.

Se devolvió en el objeto de tarea, se ha agotado el tiempo de espera del grupo de conexiones.

Devuelto en el objeto de tarea, el SqlConnection objeto se cierra antes de la ejecución del método.

Context Connection=true se especifica en el cadena de conexión.

SqlException

Se devuelve en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DataRow[]).

WriteToServerAsync(DataTable, DataRowState)

La versión asincrónica de WriteToServer(DataTable, DataRowState), que copia solo las filas que coinciden con el estado de fila proporcionado en la tabla de DataTable destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

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

Parámetros

table

DataTable

cuyas DataTable filas se copiarán en la tabla de destino.

rowState

DataRowState

Valor de la DataRowState enumeración. Solo las filas que coinciden con el estado de fila se copian en el destino.

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

Llamar a WriteToServerAsync(DataTable, DataRowState) varias veces para la misma instancia antes de la finalización de la tarea.

Llamar a WriteToServerAsync(DataTable, DataRowState) y WriteToServer(DataTable, DataRowState) para la misma instancia antes de la finalización de la tarea.

La conexión quita o se cierra durante la WriteToServerAsync(DataTable, DataRowState) ejecución.

Devuelto en el objeto de tarea, el SqlBulkCopy objeto se cerró durante la ejecución del método.

Se devolvió en el objeto de tarea, se ha agotado el tiempo de espera del grupo de conexiones.

Devuelto en el objeto de tarea, el SqlConnection objeto se cierra antes de la ejecución del método.

Context Connection=true se especifica en el cadena de conexión.

SqlException

Se devuelve en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DataTable, DataRowState).

WriteToServerAsync(DataTable, CancellationToken)

La versión asincrónica de WriteToServer(DataTable), que copia todas las filas de la tabla de destino proporcionadas DataTable en una tabla de destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

El token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se notificarán a través del objeto Task devuelto.

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

Parámetros

table

DataTable

cuyas DataTable filas se copiarán en la tabla de destino.

cancellationToken

CancellationToken

Instrucción de cancelación. Un None valor de este parámetro hace que este método sea equivalente a WriteToServerAsync(DataTable).

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

Llamar a WriteToServerAsync(DataTable) varias veces para la misma instancia antes de la finalización de la tarea.

Llamar a WriteToServerAsync(DataTable) y WriteToServer(DataTable) para la misma instancia antes de la finalización de la tarea.

La conexión quita o se cierra durante la WriteToServerAsync(DataTable) ejecución.

Devuelto en el objeto de tarea, el SqlBulkCopy objeto se cerró durante la ejecución del método.

Se devolvió en el objeto de tarea, se ha agotado el tiempo de espera del grupo de conexiones.

Devuelto en el objeto de tarea, el SqlConnection objeto se cierra antes de la ejecución del método.

Context Connection=true se especifica en el cadena de conexión.

SqlException

Se devuelve en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DataTable).

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

La versión asincrónica de WriteToServer(DataTable, DataRowState), que copia solo las filas que coinciden con el estado de fila proporcionado en la tabla de DataTable destino especificada por la DestinationTableName propiedad del SqlBulkCopy objeto .

El token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se notificarán a través del objeto Task devuelto.

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

Parámetros

table

DataTable

cuyas DataTable filas se copiarán en la tabla de destino.

rowState

DataRowState

Valor de la DataRowState enumeración. Solo las filas que coinciden con el estado de fila se copian en el destino.

cancellationToken

CancellationToken

Instrucción de cancelación. Un None valor de este parámetro hace que este método sea equivalente a WriteToServerAsync(DataTable).

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

InvalidOperationException

Llamar a WriteToServerAsync(DataTable, DataRowState) varias veces para la misma instancia antes de la finalización de la tarea.

Llamar a WriteToServerAsync(DataTable, DataRowState) y WriteToServer(DataTable, DataRowState) para la misma instancia antes de la finalización de la tarea.

La conexión quita o se cierra durante la WriteToServerAsync(DataTable, DataRowState) ejecución.

Devuelto en el objeto de tarea, el SqlBulkCopy objeto se cerró durante la ejecución del método.

Se devolvió en el objeto de tarea, se ha agotado el tiempo de espera del grupo de conexiones.

Devuelto en el objeto de tarea, el SqlConnection objeto se cierra antes de la ejecución del método.

Context Connection=true se especifica en el cadena de conexión.

SqlException

Se devuelve en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DataTable, DataRowState).