SqlBulkCopy.WriteToServerAsync Método

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v7.0.1

Sobrecargas

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

WriteToServerAsync(DbDataReader)

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::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 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 IDataReader conexión asociada se cerró antes de que se devolvió la finalización Task .
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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 IDataReader conexión asociada se cerró antes de que se devolvió la finalización Task .
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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

Tarea que representa la operación asincrónica.

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.
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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 IDataReader conexión asociada se cerró antes de que se devolvió la finalización Task .
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.

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.
• No SqlBulkCopyColumnOrderHint especificó un nombre de columna de destino válido.

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.