SqlBulkCopy.WriteToServerAsync Método

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v7.0.1

Sobrecargas

Nome	Description
WriteToServerAsync(DbDataReader)	A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas na tabela de IDataReader destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
WriteToServerAsync(DataRow[])	A versão assíncrona de WriteToServer(DataRow[]), que copia todas as linhas da matriz fornecida DataRow para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
WriteToServerAsync(DataTable)	A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas na tabela de DataTable destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
WriteToServerAsync(IDataReader)	A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas na tabela de IDataReader destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
WriteToServerAsync(DbDataReader, CancellationToken)	A versão assíncrona de WriteToServer(DbDataReader), que copia todas as linhas da matriz fornecida DbDataReader para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.
WriteToServerAsync(DataRow[], CancellationToken)	A versão assíncrona de WriteToServer(DataRow[]), que copia todas as linhas da matriz fornecida DataRow para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.
WriteToServerAsync(DataTable, DataRowState)	A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas linhas que correspondem ao estado de linha fornecido no fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
WriteToServerAsync(DataTable, CancellationToken)	A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas na tabela de DataTable destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.
WriteToServerAsync(IDataReader, CancellationToken)	A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas na tabela de IDataReader destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas linhas que correspondem ao estado de linha fornecido no fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.

WriteToServerAsync(DbDataReader)

A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas na tabela de IDataReader destino especificada pela DestinationTableName propriedade do 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

Uma IDataReader cujas linhas serão copiadas para a tabela de destino.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(IDataReader) várias vezes para a mesma instância antes da conclusão da tarefa.
• Chamando WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(IDataReader) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• O IDataReader foi fechado antes do retorno concluído Task .
• A IDataReader conexão associada foi fechada antes do retorno concluído Task .
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.

WriteToServerAsync(DataRow[])

A versão assíncrona de WriteToServer(DataRow[]), que copia todas as linhas da matriz fornecida DataRow para uma tabela de destino especificada pela DestinationTableName propriedade do 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[]

Uma matriz de DataRow objetos que será copiada para a tabela de destino.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(DataRow[]) várias vezes para a mesma instância antes da conclusão da tarefa. Chamando WriteToServerAsync(DataRow[]) e WriteToServer(DataRow[]) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(DataRow[]) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.

WriteToServerAsync(DataTable)

A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas na tabela de DataTable destino especificada pela DestinationTableName propriedade do 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

Uma DataTable cujas linhas serão copiadas para a tabela de destino.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(DataTable) várias vezes para a mesma instância antes da conclusão da tarefa.
• Chamando WriteToServerAsync(DataTable) e WriteToServer(DataTable) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(DataTable) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.

WriteToServerAsync(IDataReader)

A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas na tabela de IDataReader destino especificada pela DestinationTableName propriedade do 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

Uma IDataReader cujas linhas serão copiadas para a tabela de destino.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(IDataReader) várias vezes para a mesma instância antes da conclusão da tarefa.
• Chamando WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(IDataReader) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• O IDataReader foi fechado antes do retorno concluído Task .
• A IDataReader conexão associada foi fechada antes do retorno concluído Task .
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.

WriteToServerAsync(DbDataReader, CancellationToken)

A versão assíncrona de WriteToServer(DbDataReader), que copia todas as linhas da matriz fornecida DbDataReader para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.

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

Uma DbDataReader cujas linhas serão copiadas para a tabela de destino.

cancellationToken

CancellationToken

A instrução de cancelamento. Um None valor nesse parâmetro torna esse método equivalente a WriteToServerAsync(DbDataReader).

Retornos

Task

Uma tarefa que representa a operação assíncrona.

WriteToServerAsync(DataRow[], CancellationToken)

A versão assíncrona de WriteToServer(DataRow[]), que copia todas as linhas da matriz fornecida DataRow para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.

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[]

Uma matriz de DataRow objetos que será copiada para a tabela de destino.

cancellationToken

CancellationToken

A instrução de cancelamento. Um None valor nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(DataRow[]) várias vezes para a mesma instância antes da conclusão da tarefa.
• Chamando WriteToServerAsync(DataRow[]) e WriteToServer(DataRow[]) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(DataRow[]) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.

WriteToServerAsync(DataTable, DataRowState)

A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas linhas que correspondem ao estado de linha fornecido no fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do 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

Uma DataTable cujas linhas serão copiadas para a tabela de destino.

rowState

DataRowState

Um valor da DataRowState enumeração. Somente as linhas que correspondem ao estado da linha são copiadas para o destino.

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(DataTable, DataRowState) várias vezes para a mesma instância antes da conclusão da tarefa.
• Chamando WriteToServerAsync(DataTable, DataRowState) e WriteToServer(DataTable, DataRowState) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(DataTable, DataRowState) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.

WriteToServerAsync(DataTable, CancellationToken)

A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas na tabela de DataTable destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.

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

Uma DataTable cujas linhas serão copiadas para a tabela de destino.

cancellationToken

CancellationToken

A instrução de cancelamento. Um None valor nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(DataTable) várias vezes para a mesma instância antes da conclusão da tarefa.
• Chamando WriteToServerAsync(DataTable) e WriteToServer(DataTable) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(DataTable) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.

WriteToServerAsync(IDataReader, CancellationToken)

A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas na tabela de IDataReader destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.

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

Uma IDataReader cujas linhas serão copiadas para a tabela de destino.

cancellationToken

CancellationToken

A instrução de cancelamento. Um None valor nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(IDataReader) várias vezes para a mesma instância antes da conclusão da tarefa.
• Chamando WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(IDataReader) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• O IDataReader foi fechado antes do retorno concluído Task .
• A IDataReader conexão associada foi fechada antes do retorno concluído Task .
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas linhas que correspondem ao estado de linha fornecido no fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes que o tempo limite do comando seja decorrido. As exceções serão relatadas por meio do objeto Task retornado.

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

Uma DataTable cujas linhas serão copiadas para a tabela de destino.

rowState

DataRowState

Um valor da DataRowState enumeração. Somente as linhas que correspondem ao estado da linha são copiadas para o destino.

cancellationToken

CancellationToken

A instrução de cancelamento. Um None valor nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).

Retornos

Task

Uma tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

• Chamando WriteToServerAsync(DataTable, DataRowState) várias vezes para a mesma instância antes da conclusão da tarefa.
• Chamando WriteToServerAsync(DataTable, DataRowState) e WriteToServer(DataTable, DataRowState) para a mesma instância antes da conclusão da tarefa.
• A conexão cai ou é fechada durante WriteToServerAsync(DataTable, DataRowState) a execução.
• Retornado no objeto de tarefa, o SqlBulkCopy objeto foi fechado durante a execução do método.
• Retornado no objeto de tarefa, havia um tempo limite do pool de conexões.
• Retornado no objeto de tarefa, o SqlConnection objeto é fechado antes da execução do método.
• Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

SqlException

Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.

Comentários

Para obter mais informações sobre programação assíncrona no Provedor de Dados do .NET Framework para SQL Server, consulte Programação Assíncrona.