SqlBulkCopy.WriteToServerAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
| Name | Description |
|---|---|
| WriteToServerAsync(IDataReader, CancellationToken) |
A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas do fornecido IDataReader para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido. |
| WriteToServerAsync(DbDataReader) |
A versão assíncrona de WriteToServer(DbDataReader), que copia todas as linhas do array fornecido 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 do array fornecido 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 do fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. |
| WriteToServerAsync(IDataReader) |
A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas do fornecido IDataReader para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. |
| WriteToServerAsync(DbDataReader, CancellationToken) |
A versão assíncrona de WriteToServer(DbDataReader), que copia todas as linhas do array fornecido 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 do array fornecido DataRow para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido. |
| WriteToServerAsync(DataTable, DataRowState) |
A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas as linhas que correspondem ao estado da linha fornecida 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 do fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido. |
| WriteToServerAsync(DataTable, DataRowState, CancellationToken) |
A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas as linhas que correspondem ao estado da linha fornecida no fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto. O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido. |
Observações
Se múltiplos conjuntos de resultados ativos (MARS) estiverem desativados, WriteToServer a ligação fica ocupada. Se o MARS estiver ativado, podes intercalar chamadas com WriteToServer outros comandos na mesma ligação.
O número de linhas que são recuadas quando uma falha depende de vários fatores:
Se UseInternalTransaction for especificado.
Se tiver a sua própria transação.
O valor de BatchSize.
Quando há um erro ao enviar dados para o servidor, o lote atual (conforme especificado por BatchSize) será revertido. Se UseInternalTransaction não for especificado e tiveres a tua própria transação, toda a transação será revertida (incluindo todos os lotes anteriores).
Antes SqlRowsCopied sabia quantas linhas eram copiadas para o servidor.
WriteToServerAsync(IDataReader, CancellationToken)
A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas do fornecido IDataReader para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido.
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
A IDataReader cujas linhas serão copiadas para a tabela de destino.
- cancellationToken
- CancellationToken
A instrução de cancelamento. Um None valor neste parâmetro torna este método equivalente a WriteToServerAsync(DataTable).
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar 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 ligação cai ou é fechada durante WriteToServerAsync(IDataReader) a execução.
Devolvido no objeto tarefa, o SqlBulkCopy objeto era fechado durante a execução do método.
Devolvido no objeto tarefa, havia um timeout para pool de ligações.
Devolvido no objeto tarefa, o SqlConnection objeto é fechado antes da execução do método.
Foi IDataReader encerrado antes de o completo Task regressar.
A IDataReaderligação associada a a foi encerrada antes do regresso do completado Task .
Context Connection=true está especificado no cadeia de ligação.
Retornado no objeto tarefa, qualquer erro devolvido pelo SQL Server que tenha ocorrido ao abrir a ligação.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(IDataReader).
Aplica-se a
WriteToServerAsync(DbDataReader)
A versão assíncrona de WriteToServer(DbDataReader), que copia todas as linhas do array fornecido 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.Task
Public Function WriteToServerAsync (reader As DbDataReader) As Task
Parâmetros
- reader
- DbDataReader
A DbDataReader cujas linhas serão copiadas para a tabela de destino.
Devoluções
Uma tarefa que representa a operação assíncrona.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(DbDataReader).
Aplica-se a
WriteToServerAsync(DataRow[])
A versão assíncrona de WriteToServer(DataRow[]), que copia todas as linhas do array fornecido 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
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar 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 ligação cai ou é fechada durante WriteToServerAsync(DataRow[]) a execução.
Devolvido no objeto tarefa, o SqlBulkCopy objeto era fechado durante a execução do método.
Devolvido no objeto tarefa, havia um timeout para pool de ligações.
Devolvido no objeto tarefa, o SqlConnection objeto é fechado antes da execução do método.
Context Connection=true está especificado no cadeia de ligação.
Retornado no objeto tarefa, qualquer erro devolvido pelo SQL Server que tenha ocorrido ao abrir a ligação.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(DataRow[]).
Aplica-se a
WriteToServerAsync(DataTable)
A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas do fornecido DataTable para uma tabela de 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
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar 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 ligação cai ou é fechada durante WriteToServerAsync(DataTable) a execução.
Devolvido no objeto tarefa, o SqlBulkCopy objeto era fechado durante a execução do método.
Devolvido no objeto tarefa, havia um timeout para pool de ligações.
Devolvido no objeto tarefa, o SqlConnection objeto é fechado antes da execução do método.
Context Connection=true está especificado no cadeia de ligação.
Retornado no objeto tarefa, qualquer erro devolvido pelo SQL Server que tenha ocorrido ao abrir a ligação.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(DataTable).
Aplica-se a
WriteToServerAsync(IDataReader)
A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas do fornecido IDataReader para uma tabela de 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
A IDataReader cujas linhas serão copiadas para a tabela de destino.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar 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 ligação cai ou é fechada durante WriteToServerAsync(IDataReader) a execução.
Devolvido no objeto tarefa, o SqlBulkCopy objeto era fechado durante a execução do método.
Devolvido no objeto tarefa, havia um timeout para pool de ligações.
Devolvido no objeto tarefa, o SqlConnection objeto é fechado antes da execução do método.
Foi IDataReader encerrado antes de o completo Task regressar.
A IDataReaderligação associada a a foi encerrada antes do regresso do completado Task .
Context Connection=true está especificado no cadeia de ligação.
Retornado no objeto tarefa, qualquer erro devolvido pelo SQL Server que tenha ocorrido ao abrir a ligação.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(IDataReader).
Aplica-se a
WriteToServerAsync(DbDataReader, CancellationToken)
A versão assíncrona de WriteToServer(DbDataReader), que copia todas as linhas do array fornecido 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.Task
Public Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As Task
Parâmetros
- reader
- DbDataReader
A DbDataReader cujas linhas serão copiadas para a tabela de destino.
- cancellationToken
- CancellationToken
A instrução de cancelamento. Um None valor neste parâmetro torna este método equivalente a WriteToServerAsync(DbDataReader).
Devoluções
Retorna Task.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(DbDataReader).
Aplica-se a
WriteToServerAsync(DataRow[], CancellationToken)
A versão assíncrona de WriteToServer(DataRow[]), que copia todas as linhas do array fornecido DataRow para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido.
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
- cancellationToken
- CancellationToken
A instrução de cancelamento. Um None valor neste parâmetro torna este método equivalente a WriteToServerAsync(DataTable).
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar 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 ligação cai ou é fechada durante WriteToServerAsync(DataRow[]) a execução.
Devolvido no objeto tarefa, o SqlBulkCopy objeto era fechado durante a execução do método.
Devolvido no objeto tarefa, havia um timeout para pool de ligações.
Devolvido no objeto tarefa, o SqlConnection objeto é fechado antes da execução do método.
Context Connection=true está especificado no cadeia de ligação.
Retornado no objeto tarefa, qualquer erro devolvido pelo SQL Server que tenha ocorrido ao abrir a ligação.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(DataRow[]).
Aplica-se a
WriteToServerAsync(DataTable, DataRowState)
A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas as linhas que correspondem ao estado da linha fornecida 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
- rowState
- DataRowState
Um valor da DataRowState enumeração. Apenas as linhas que correspondem ao estado da linha são copiadas para o destino.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar 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 ligação cai ou é fechada durante WriteToServerAsync(DataTable, DataRowState) a execução.
Devolvido no objeto tarefa, o SqlBulkCopy objeto era fechado durante a execução do método.
Devolvido no objeto tarefa, havia um timeout para pool de ligações.
Devolvido no objeto tarefa, o SqlConnection objeto é fechado antes da execução do método.
Context Connection=true está especificado no cadeia de ligação.
Retornado no objeto tarefa, qualquer erro devolvido pelo SQL Server que tenha ocorrido ao abrir a ligação.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(DataTable, DataRowState).
Aplica-se a
WriteToServerAsync(DataTable, CancellationToken)
A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas do fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido.
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
- cancellationToken
- CancellationToken
A instrução de cancelamento. Um None valor neste parâmetro torna este método equivalente a WriteToServerAsync(DataTable).
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar 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 ligação cai ou é fechada durante WriteToServerAsync(DataTable) a execução.
Devolvido no objeto tarefa, o SqlBulkCopy objeto era fechado durante a execução do método.
Devolvido no objeto tarefa, havia um timeout para pool de ligações.
Devolvido no objeto tarefa, o SqlConnection objeto é fechado antes da execução do método.
Context Connection=true está especificado no cadeia de ligação.
Retornado no objeto tarefa, qualquer erro devolvido pelo SQL Server que tenha ocorrido ao abrir a ligação.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(DataTable).
Aplica-se a
WriteToServerAsync(DataTable, DataRowState, CancellationToken)
A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas as linhas que correspondem ao estado da linha fornecida no fornecido DataTable para uma tabela de destino especificada pela DestinationTableName propriedade do SqlBulkCopy objeto.
O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido.
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
- rowState
- DataRowState
Um valor da DataRowState enumeração. Apenas as linhas que correspondem ao estado da linha são copiadas para o destino.
- cancellationToken
- CancellationToken
A instrução de cancelamento. Um None valor neste parâmetro torna este método equivalente a WriteToServerAsync(DataTable).
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar 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 ligação cai ou é fechada durante WriteToServerAsync(DataTable, DataRowState) a execução.
Devolvido no objeto tarefa, o SqlBulkCopy objeto era fechado durante a execução do método.
Devolvido no objeto tarefa, havia um timeout para pool de ligações.
Devolvido no objeto tarefa, o SqlConnection objeto é fechado antes da execução do método.
Context Connection=true está especificado no cadeia de ligação.
Retornado no objeto tarefa, qualquer erro devolvido pelo SQL Server que tenha ocorrido ao abrir a ligação.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteToServer(DataTable, DataRowState).