SqlBulkCopy.WriteToServerAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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:
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, 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.TaskPublic Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As TaskPará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
Tarea que representa la operación asincrónica.
Excepciones
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.
Devuelto en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader) As TaskParámetros
- reader
- DbDataReader
DbDataReader cuyas filas se van a copiar a la tabla de destino.
Devoluciones
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.TaskPublic Function WriteToServerAsync (rows As DataRow()) As TaskParámetros
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
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.
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.TaskPublic Function WriteToServerAsync (table As DataTable) As TaskParámetros
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
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.
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(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.TaskPublic Function WriteToServerAsync (reader As IDataReader) As TaskParámetros
- reader
- IDataReader
IDataReader cuyas filas se van a copiar a la tabla de destino.
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
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.
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(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.TaskPublic Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As TaskPará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
Devuelve Task.
Excepciones
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, 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[], 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.TaskPublic Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As TaskParámetros
- 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
Tarea que representa la operación asincrónica.
Excepciones
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.
Devuelto en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.
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(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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As TaskParámetros
- 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
Tarea que representa la operación asincrónica.
Excepciones
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.
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(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.TaskPublic Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As TaskParámetros
- 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
Tarea que representa la operación asincrónica.
Excepciones
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.
Devuelto en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.
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(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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As TaskParámetros
- 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
Tarea que representa la operación asincrónica.
Excepciones
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.
Devuelto en el objeto de tarea, cualquier error devuelto por SQL Server que se produjo al abrir la conexión.
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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de