SqlBulkCopy.WriteToServerAsync Método

Definição

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:

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

rows
DataRow[]

Um array de DataRow objetos que serão copiados para a tabela de destino.

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

table
DataTable

A DataTable 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(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

rows
DataRow[]

Um array de DataRow objetos que serão copiados 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(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

table
DataTable

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

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

table
DataTable

A DataTable 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(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

table
DataTable

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

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

Aplica-se a