SqlBulkCopy.WriteToServerAsync Método

  • Referencia

Definición

Espacio de nombres:
System.Data.SqlClient
Ensamblado:
System.Data.dll
Ensamblados:
netstandard.dll, System.Data.SqlClient.dll
Ensamblado:
System.Data.SqlClient.dll
Paquete:
System.Data.SqlClient v4.8.6

Versión asincrónica de WriteToServer que copia todas las filas de un origen de datos en la tabla de destino especificada por la propiedad DestinationTableName del objeto SqlBulkCopy.

Sobrecargas

WriteToServerAsync(IDataReader, CancellationToken)

Versión asincrónica de WriteToServer(IDataReader) que copia todas las finales en la IDataReader suministrada a una tabla de destino que especifica la propiedad DestinationTableName del objeto SqlBulkCopy.

Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrarán a través del objeto Task devuelto.
WriteToServerAsync(DbDataReader)

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

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

Versión asincrónica de WriteToServer(DataTable) que copia todas las finales en la DataTable suministrada a una tabla de destino que especifica la propiedad DestinationTableName del objeto SqlBulkCopy.
WriteToServerAsync(IDataReader)

Versión asincrónica de WriteToServer(IDataReader) que copia todas las finales en la IDataReader suministrada a una tabla de destino que especifica la propiedad DestinationTableName del objeto SqlBulkCopy.
WriteToServerAsync(DbDataReader, CancellationToken)

Versión asincrónica de WriteToServer(DbDataReader), que copia todas las filas de la matriz DbDataReader suministrada en una tabla de destino especificada por la propiedad DestinationTableName del objeto SqlBulkCopy.
WriteToServerAsync(DataRow[], CancellationToken)

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

Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrarán a través del objeto Task devuelto.
WriteToServerAsync(DataTable, DataRowState)

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

Versión asincrónica de WriteToServer(DataTable) que copia todas las finales en la DataTable suministrada a una tabla de destino que especifica la propiedad DestinationTableName del objeto SqlBulkCopy.

Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrarán a través del objeto Task devuelto.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)

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

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

Comentarios

Si se deshabilitan varios conjuntos de resultados activos (MARS), WriteToServer la conexión estará 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:

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, se revertirá toda la transacción (que incluye también todos los lotes anteriores).

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

WriteToServerAsync(IDataReader, CancellationToken)

Versión asincrónica de WriteToServer(IDataReader) que copia todas las finales en la IDataReader suministrada a una tabla de destino que especifica la propiedad DestinationTableName del objeto SqlBulkCopy.

Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrará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

IDataReader cuyas filas se van a copiar a la tabla de destino.

cancellationToken
CancellationToken

Instrucción de cancelación. Un valor None en 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 a WriteToServer(IDataReader) para la misma instancia antes de la finalización de la tarea.

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

Se devuelve en el objeto Task; el objeto SqlBulkCopy se cerró durante la ejecución del método.

Se devuelve en el objeto Task; se superó el tiempo de espera del grupo de conexiones.

Se devuelve en el objeto Task; el objeto SqlConnection se cierra antes de la ejecución del método.

IDataReader se cerró antes de que volviera la Task completada.

La conexión asociada de IDataReader se cerró antes de que volviera la Task completada.

Se especifica Context Connection=true en la cadena de conexión.

SqlException

Devuelto 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(IDataReader).

Se aplica a

WriteToServerAsync(DbDataReader)

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

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

DbDataReader cuyas filas se van a copiar a 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DbDataReader).

Se aplica a

WriteToServerAsync(DataRow[])

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

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 objetos DataRow que se va a copiar a 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 a WriteToServer(DataRow[]) para la misma instancia antes de la finalización de la tarea.

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

Se devuelve en el objeto Task; el objeto SqlBulkCopy se cerró durante la ejecución del método.

Se devuelve en el objeto Task; se superó el tiempo de espera del grupo de conexiones.

Se devuelve en el objeto Task; el objeto SqlConnection se cierra antes de la ejecución del método.

Se especifica Context Connection=true en la cadena de conexión.

SqlException

Devuelto 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por WriteToServer(DataRow[]).

Se aplica a

WriteToServerAsync(DataTable)

Versión asincrónica de WriteToServer(DataTable) que copia todas las finales en la DataTable suministrada a una tabla de destino que especifica la propiedad DestinationTableName del objeto SqlBulkCopy.

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

DataTable cuyas filas se van a copiar a 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 a WriteToServer(DataTable) para la misma instancia antes de la finalización de la tarea.

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

Se devuelve en el objeto Task; el objeto SqlBulkCopy se cerró durante la ejecución del método.

Se devuelve en el objeto Task; se superó el tiempo de espera del grupo de conexiones.

Se devuelve en el objeto Task; el objeto SqlConnection se cierra antes de la ejecución del método.

Se especifica Context Connection=true en la cadena de conexión.

SqlException

Devuelto 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por WriteToServer(DataTable).

Se aplica a

WriteToServerAsync(IDataReader)

Versión asincrónica de WriteToServer(IDataReader) que copia todas las finales en la IDataReader suministrada a una tabla de destino que especifica la propiedad DestinationTableName del objeto SqlBulkCopy.

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

IDataReader cuyas filas se van a copiar a 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 a WriteToServer(IDataReader) para la misma instancia antes de la finalización de la tarea.

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

Se devuelve en el objeto Task; el objeto SqlBulkCopy se cerró durante la ejecución del método.

Se devuelve en el objeto Task; se superó el tiempo de espera del grupo de conexiones.

Se devuelve en el objeto Task; el objeto SqlConnection se cierra antes de la ejecución del método.

IDataReader se cerró antes de que volviera la Task completada.

La conexión asociada de IDataReader se cerró antes de que volviera la Task completada.

Se especifica Context Connection=true en la cadena de conexión.

SqlException

Devuelto 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

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

Se aplica a

WriteToServerAsync(DbDataReader, CancellationToken)

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

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

DbDataReader cuyas filas se van a copiar a la tabla de destino.

cancellationToken
CancellationToken

Instrucción de cancelación. Un valor None en 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 que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por WriteToServer(DbDataReader).

Se aplica a

WriteToServerAsync(DataRow[], CancellationToken)

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

Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrará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 objetos DataRow que se va a copiar a la tabla de destino.

cancellationToken
CancellationToken

Instrucción de cancelación. Un valor None en 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 a WriteToServer(DataRow[]) para la misma instancia antes de la finalización de la tarea.

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

Se devuelve en el objeto Task; el objeto SqlBulkCopy se cerró durante la ejecución del método.

Se devuelve en el objeto Task; se superó el tiempo de espera del grupo de conexiones.

Se devuelve en el objeto Task; el objeto SqlConnection se cierra antes de la ejecución del método.

Se especifica Context Connection=true en la cadena de conexión.

SqlException

Devuelto 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

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

Se aplica a

WriteToServerAsync(DataTable, DataRowState)

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

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

DataTable cuyas filas se van a copiar a la tabla de destino.

rowState
DataRowState

Un valor de la enumeración DataRowState. Sólo se copian al destino las filas que coinciden con el estado de fila.

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 a WriteToServer(DataTable, DataRowState) para la misma instancia antes de la finalización de la tarea.

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

Se devuelve en el objeto Task; el objeto SqlBulkCopy se cerró durante la ejecución del método.

Se devuelve en el objeto Task; se superó el tiempo de espera del grupo de conexiones.

Se devuelve en el objeto Task; el objeto SqlConnection se cierra antes de la ejecución del método.

Se especifica Context Connection=true en la cadena de conexión.

SqlException

Devuelto 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

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

Se aplica a

WriteToServerAsync(DataTable, CancellationToken)

Versión asincrónica de WriteToServer(DataTable) que copia todas las finales en la DataTable suministrada a una tabla de destino que especifica la propiedad DestinationTableName del objeto SqlBulkCopy.

Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrará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

DataTable cuyas filas se van a copiar a la tabla de destino.

cancellationToken
CancellationToken

Instrucción de cancelación. Un valor None en 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 a WriteToServer(DataTable) para la misma instancia antes de la finalización de la tarea.

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

Se devuelve en el objeto Task; el objeto SqlBulkCopy se cerró durante la ejecución del método.

Se devuelve en el objeto Task; se superó el tiempo de espera del grupo de conexiones.

Se devuelve en el objeto Task; el objeto SqlConnection se cierra antes de la ejecución del método.

Se especifica Context Connection=true en la cadena de conexión.

SqlException

Devuelto 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

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

Se aplica a

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

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

Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrará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

DataTable cuyas filas se van a copiar a la tabla de destino.

rowState
DataRowState

Un valor de la enumeración DataRowState. Sólo se copian al destino las filas que coinciden con el estado de fila.

cancellationToken
CancellationToken

Instrucción de cancelación. Un valor None en 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 a WriteToServer(DataTable, DataRowState) para la misma instancia antes de la finalización de la tarea.

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

Se devuelve en el objeto Task; el objeto SqlBulkCopy se cerró durante la ejecución del método.

Se devuelve en el objeto Task; se superó el tiempo de espera del grupo de conexiones.

Se devuelve en el objeto Task; el objeto SqlConnection se cierra antes de la ejecución del método.

Se especifica Context Connection=true en la cadena de conexión.

SqlException

Devuelto 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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

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

Se aplica a