SqlBulkCopy.WriteToServerAsync Método

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Sobrecargas

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)	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(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(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. 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.
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(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(DbDataReader)	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(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(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(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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.

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::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

Tarea que representa la operación asincrónica.

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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

WriteToServerAsync(DbDataReader)

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::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

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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.

No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.