SqlBulkCopy.WriteToServerAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Uma versão assíncrona de WriteToServer, que copia todas as linhas de uma fonte de dados para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
Sobrecargas
| Nome | Description |
|---|---|
| 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(DbDataReader) |
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. |
| 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. |
| 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(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. |
Comentários
Se vários MARS (conjuntos de resultados ativos) estiverem desabilitados, WriteToServer a conexão estará ocupada. Se o MARS estiver habilitado, você poderá intercalar chamadas WriteToServer com outros comandos na mesma conexão.
O número de linhas revertidas quando uma falha depende de várias coisas:
Se UseInternalTransaction for especificado.
Se você tiver sua própria transação.
O valor de BatchSize.
Quando houver um erro ao enviar dados para o servidor, o lote atual (conforme especificado por BatchSize) será revertido. Se UseInternalTransaction não for especificado e você tiver sua própria transação, toda a transação será revertida (o que inclui todos os lotes anteriores também).
Use SqlRowsCopied para saber quantas linhas foram copiadas para o servidor.
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.TaskPublic Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As TaskParâ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
Uma tarefa que representa a operação assíncrona.
Exceções
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 IDataReaderconexão associada foi fechada antes do retorno concluído Task .
Context Connection=true é especificado no cadeia de conexão.
Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(IDataReader).
Aplica-se a
WriteToServerAsync(DbDataReader)
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.
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
Uma DbDataReader cujas linhas serão copiadas para a tabela de destino.
Retornos
Uma tarefa que representa a operação assíncrona.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(DbDataReader).
Aplica-se a
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.TaskPublic Function WriteToServerAsync (rows As DataRow()) As TaskParâmetros
Retornos
Uma tarefa que representa a operação assíncrona.
Exceções
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.
Context Connection=true é especificado no cadeia de conexão.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(DataRow[]).
Aplica-se a
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.TaskPublic Function WriteToServerAsync (table As DataTable) As TaskParâmetros
Retornos
Uma tarefa que representa a operação assíncrona.
Exceções
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.
Context Connection=true é especificado no cadeia de conexão.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(DataTable).
Aplica-se a
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.TaskPublic Function WriteToServerAsync (reader As IDataReader) As TaskParâmetros
- reader
- IDataReader
Uma IDataReader cujas linhas serão copiadas para a tabela de destino.
Retornos
Uma tarefa que representa a operação assíncrona.
Exceções
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 IDataReaderconexão associada foi fechada antes do retorno concluído Task .
Context Connection=true é especificado no cadeia de conexão.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(IDataReader).
Aplica-se a
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.
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
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
Retorna Task.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(DbDataReader).
Aplica-se a
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.TaskPublic Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As TaskParâmetros
- cancellationToken
- CancellationToken
A instrução de cancelamento. Um None valor nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).
Retornos
Uma tarefa que representa a operação assíncrona.
Exceções
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.
Context Connection=true é especificado no cadeia de conexão.
Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(DataRow[]).
Aplica-se a
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As TaskParâmetros
- rowState
- DataRowState
Um valor da DataRowState enumeração. Somente as linhas que correspondem ao estado da linha são copiadas para o destino.
Retornos
Uma tarefa que representa a operação assíncrona.
Exceções
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.
Context Connection=true é especificado no cadeia de conexão.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(DataTable, DataRowState).
Aplica-se a
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.TaskPublic Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As TaskParâmetros
- cancellationToken
- CancellationToken
A instrução de cancelamento. Um None valor nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).
Retornos
Uma tarefa que representa a operação assíncrona.
Exceções
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.
Context Connection=true é especificado no cadeia de conexão.
Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(DataTable).
Aplica-se a
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As TaskParâmetros
- 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
Uma tarefa que representa a operação assíncrona.
Exceções
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.
Context Connection=true é especificado no cadeia de conexão.
Retornado no objeto de tarefa, qualquer erro retornado por SQL Server que ocorreu ao abrir a conexão.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
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.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteToServer(DataTable, DataRowState).