SqlBulkCopy.WriteToServerAsync SqlBulkCopy.WriteToServerAsync SqlBulkCopy.WriteToServerAsync SqlBulkCopy.WriteToServerAsync Method

Definição

Uma versão assíncrona do WriteToServer, que copia todas as linhas de uma fonte de dados para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.An asynchronous version of WriteToServer, which copies all rows from a data source to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

Sobrecargas

WriteToServerAsync(IDataReader, CancellationToken) WriteToServerAsync(IDataReader, CancellationToken) WriteToServerAsync(IDataReader, CancellationToken)

A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas no IDataReader fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(IDataReader), which copies all rows in the supplied IDataReader to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

WriteToServerAsync(DbDataReader) WriteToServerAsync(DbDataReader) WriteToServerAsync(DbDataReader) WriteToServerAsync(DbDataReader)

A versão assíncrona do WriteToServer(DbDataReader), que copia todas as linhas da matriz DbDataReader fornecida para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DbDataReader), which copies all rows from the supplied DbDataReader array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DataRow[]) WriteToServerAsync(DataRow[]) WriteToServerAsync(DataRow[]) WriteToServerAsync(DataRow[])

A versão assíncrona do WriteToServer(DataRow[]), que copia todas as linhas da matriz DataRow fornecida para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataRow[]), which copies all rows from the supplied DataRow array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DataTable) WriteToServerAsync(DataTable) WriteToServerAsync(DataTable) WriteToServerAsync(DataTable)

A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas no DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataTable), which copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(IDataReader) WriteToServerAsync(IDataReader) WriteToServerAsync(IDataReader) WriteToServerAsync(IDataReader)

A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas no IDataReader fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(IDataReader), which copies all rows in the supplied IDataReader to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DbDataReader, CancellationToken) WriteToServerAsync(DbDataReader, CancellationToken) WriteToServerAsync(DbDataReader, CancellationToken)

A versão assíncrona do WriteToServer(DbDataReader), que copia todas as linhas da matriz DbDataReader fornecida para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DbDataReader), which copies all rows from the supplied DbDataReader array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DataRow[], CancellationToken) WriteToServerAsync(DataRow[], CancellationToken) WriteToServerAsync(DataRow[], CancellationToken)

A versão assíncrona do WriteToServer(DataRow[]), que copia todas as linhas da matriz DataRow fornecida para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataRow[]), which copies all rows from the supplied DataRow array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

WriteToServerAsync(DataTable, DataRowState) WriteToServerAsync(DataTable, DataRowState) WriteToServerAsync(DataTable, DataRowState) WriteToServerAsync(DataTable, DataRowState)

A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas linhas que correspondem ao estado de linha fornecido no DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataTable, DataRowState), which copies only rows that match the supplied row state in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

WriteToServerAsync(DataTable, CancellationToken) WriteToServerAsync(DataTable, CancellationToken) WriteToServerAsync(DataTable, CancellationToken)

A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas no DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataTable), which copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

WriteToServerAsync(DataTable, DataRowState, CancellationToken) WriteToServerAsync(DataTable, DataRowState, CancellationToken) 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 DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataTable, DataRowState), which copies only rows that match the supplied row state in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

Comentários

Se o Mars (vários conjuntos de resultados ativos) estiver WriteToServer desabilitado, o tornará a conexão ocupada.If multiple active result sets (MARS) is disabled, WriteToServer makes the connection busy. Se o Mars estiver habilitado, você poderá intercalar chamadas para WriteToServer com outros comandos na mesma conexão.If MARS is enabled, you can interleave calls to WriteToServer with other commands in the same connection.

O número de linhas que são revertidas quando uma falha depende de várias coisas:The number of rows that are rolled back when one fails depends on several things:

Quando houver um erro ao enviar dados para o servidor, o lote atual (conforme especificado por BatchSize) será revertido.When there is an error while sending data to the server, the current batch (as specified by BatchSize) will be rolled back. 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).If UseInternalTransaction is not specified and you have your own transaction, the entire transaction will be rolled back (which includes all previous batches as well).

Use SqlRowsCopied para saber quantas linhas foram copiadas para o servidor.Use SqlRowsCopied to know how many rows were copied to the server.

WriteToServerAsync(IDataReader, CancellationToken) WriteToServerAsync(IDataReader, CancellationToken) WriteToServerAsync(IDataReader, CancellationToken)

A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas no IDataReader fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(IDataReader), which copies all rows in the supplied IDataReader to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

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

Parâmetros

reader
IDataReader IDataReader IDataReader IDataReader

Um IDataReader cujas linhas serão copiadas para a tabela de destino.A IDataReader whose rows will be copied to the destination table.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

A instrução de cancelamento.The cancellation instruction. Um valor None nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).A None value in this parameter makes this method equivalent to WriteToServerAsync(DataTable).

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando WriteToServerAsync(IDataReader) várias vezes para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(IDataReader) multiple times for the same instance before task completion.

Chamando WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(IDataReader) and WriteToServer(IDataReader) for the same instance before task completion.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(IDataReader).The connection drops or is closed during WriteToServerAsync(IDataReader) execution.

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.Returned in the task object, there was a connection pool timeout.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.Returned in the task object, the SqlConnection object is closed before method execution.

O IDataReader foi fechado antes de o Task preenchido ser retornado.The IDataReader was closed before the completed Task returned.

A conexão associada do IDataReader foi fechada antes de o Task preenchido ser retornado.The IDataReader's associated connection was closed before the completed Task returned.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Retornado no objeto de tarefa, qualquer erro retornado pelo SQL Server que ocorreu ao abrir a conexão.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Comentários

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DbDataReader) WriteToServerAsync(DbDataReader) WriteToServerAsync(DbDataReader) WriteToServerAsync(DbDataReader)

A versão assíncrona do WriteToServer(DbDataReader), que copia todas as linhas da matriz DbDataReader fornecida para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DbDataReader), which copies all rows from the supplied DbDataReader array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

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 DbDataReader DbDataReader DbDataReader

Um DbDataReader cujas linhas serão copiadas para a tabela de destino.A DbDataReader whose rows will be copied to the destination table.

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

WriteToServerAsync(DataRow[]) WriteToServerAsync(DataRow[]) WriteToServerAsync(DataRow[]) WriteToServerAsync(DataRow[])

A versão assíncrona do WriteToServer(DataRow[]), que copia todas as linhas da matriz DataRow fornecida para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataRow[]), which copies all rows from the supplied DataRow array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

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 objetos DataRow que será copiada para a tabela de destino.An array of DataRow objects that will be copied to the destination table.

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando WriteToServerAsync(DataRow[]) várias vezes para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataRow[]) multiple times for the same instance before task completion.

Chamando WriteToServerAsync(DataRow[]) e WriteToServer(DataRow[]) para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataRow[]) and WriteToServer(DataRow[]) for the same instance before task completion.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataRow[]).The connection drops or is closed during WriteToServerAsync(DataRow[]) execution.

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.Returned in the task object, there was a connection pool timeout.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Retornado no objeto de tarefa, qualquer erro retornado pelo SQL Server que ocorreu ao abrir a conexão.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Comentários

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DataTable) WriteToServerAsync(DataTable) WriteToServerAsync(DataTable) WriteToServerAsync(DataTable)

A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas no DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataTable), which copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

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

Um DataTable cujas linhas serão copiadas para a tabela de destino.A DataTable whose rows will be copied to the destination table.

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando WriteToServerAsync(DataTable) várias vezes para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataTable) multiple times for the same instance before task completion.

Chamando WriteToServerAsync(DataTable) e WriteToServer(DataTable) para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataTable) and WriteToServer(DataTable) for the same instance before task completion.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataTable).The connection drops or is closed during WriteToServerAsync(DataTable) execution.

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.Returned in the task object, there was a connection pool timeout.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Retornado no objeto de tarefa, qualquer erro retornado pelo SQL Server que ocorreu ao abrir a conexão.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Comentários

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(IDataReader) WriteToServerAsync(IDataReader) WriteToServerAsync(IDataReader) WriteToServerAsync(IDataReader)

A versão assíncrona de WriteToServer(IDataReader), que copia todas as linhas no IDataReader fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(IDataReader), which copies all rows in the supplied IDataReader to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

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 IDataReader IDataReader IDataReader

Um IDataReader cujas linhas serão copiadas para a tabela de destino.A IDataReader whose rows will be copied to the destination table.

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando WriteToServerAsync(IDataReader) várias vezes para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(IDataReader) multiple times for the same instance before task completion.

Chamando WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(IDataReader) and WriteToServer(IDataReader) for the same instance before task completion.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(IDataReader).The connection drops or is closed during WriteToServerAsync(IDataReader) execution.

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.Returned in the task object, there was a connection pool timeout.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.Returned in the task object, the SqlConnection object is closed before method execution.

O IDataReader foi fechado antes de o Task preenchido ser retornado.The IDataReader was closed before the completed Task returned.

A conexão associada do IDataReader foi fechada antes de o Task preenchido ser retornado.The IDataReader's associated connection was closed before the completed Task returned.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Retornado no objeto de tarefa, qualquer erro retornado pelo SQL Server que ocorreu ao abrir a conexão.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Comentários

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DbDataReader, CancellationToken) WriteToServerAsync(DbDataReader, CancellationToken) WriteToServerAsync(DbDataReader, CancellationToken)

A versão assíncrona do WriteToServer(DbDataReader), que copia todas as linhas da matriz DbDataReader fornecida para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DbDataReader), which copies all rows from the supplied DbDataReader array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

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

Parâmetros

reader
DbDataReader DbDataReader DbDataReader DbDataReader

Um DbDataReader cujas linhas serão copiadas para a tabela de destino.A DbDataReader whose rows will be copied to the destination table.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

A instrução de cancelamento.The cancellation instruction. Um valor None nesse parâmetro torna esse método equivalente a WriteToServerAsync(DbDataReader).A None value in this parameter makes this method equivalent to WriteToServerAsync(DbDataReader).

Retornos

Retorna Task.Returns Task.

WriteToServerAsync(DataRow[], CancellationToken) WriteToServerAsync(DataRow[], CancellationToken) WriteToServerAsync(DataRow[], CancellationToken)

A versão assíncrona do WriteToServer(DataRow[]), que copia todas as linhas da matriz DataRow fornecida para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataRow[]), which copies all rows from the supplied DataRow array to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

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

Parâmetros

rows
DataRow[]

Uma matriz de objetos DataRow que será copiada para a tabela de destino.An array of DataRow objects that will be copied to the destination table.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

A instrução de cancelamento.The cancellation instruction. Um valor None nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).A None value in this parameter makes this method equivalent to WriteToServerAsync(DataTable).

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando WriteToServerAsync(DataRow[]) várias vezes para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataRow[]) multiple times for the same instance before task completion.

Chamando WriteToServerAsync(DataRow[]) e WriteToServer(DataRow[]) para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataRow[]) and WriteToServer(DataRow[]) for the same instance before task completion.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataRow[]).The connection drops or is closed during WriteToServerAsync(DataRow[]) execution.

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.Returned in the task object, there was a connection pool timeout.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Retornado no objeto de tarefa, qualquer erro retornado pelo SQL Server que ocorreu ao abrir a conexão.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Comentários

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DataTable, DataRowState) WriteToServerAsync(DataTable, DataRowState) WriteToServerAsync(DataTable, DataRowState) WriteToServerAsync(DataTable, DataRowState)

A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas linhas que correspondem ao estado de linha fornecido no DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataTable, DataRowState), which copies only rows that match the supplied row state in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

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

Um DataTable cujas linhas serão copiadas para a tabela de destino.A DataTable whose rows will be copied to the destination table.

rowState
DataRowState DataRowState DataRowState DataRowState

Um valor da enumeração DataRowState.A value from the DataRowState enumeration. Somente as linhas que correspondem ao estado de linha são copiadas para o destino.Only rows matching the row state are copied to the destination.

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando WriteToServerAsync(DataTable, DataRowState) várias vezes para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataTable, DataRowState) multiple times for the same instance before task completion.

Chamando WriteToServerAsync(DataTable, DataRowState) e WriteToServer(DataTable, DataRowState) para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataTable, DataRowState) and WriteToServer(DataTable, DataRowState) for the same instance before task completion.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataTable, DataRowState).The connection drops or is closed during WriteToServerAsync(DataTable, DataRowState) execution.

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.Returned in the task object, there was a connection pool timeout.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Retornado no objeto de tarefa, qualquer erro retornado pelo SQL Server que ocorreu ao abrir a conexão.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Comentários

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DataTable, CancellationToken) WriteToServerAsync(DataTable, CancellationToken) WriteToServerAsync(DataTable, CancellationToken)

A versão assíncrona de WriteToServer(DataTable), que copia todas as linhas no DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataTable), which copies all rows in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

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

Parâmetros

table
DataTable DataTable DataTable DataTable

Um DataTable cujas linhas serão copiadas para a tabela de destino.A DataTable whose rows will be copied to the destination table.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

A instrução de cancelamento.The cancellation instruction. Um valor None nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).A None value in this parameter makes this method equivalent to WriteToServerAsync(DataTable).

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando WriteToServerAsync(DataTable) várias vezes para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataTable) multiple times for the same instance before task completion.

Chamando WriteToServerAsync(DataTable) e WriteToServer(DataTable) para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataTable) and WriteToServer(DataTable) for the same instance before task completion.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataTable).The connection drops or is closed during WriteToServerAsync(DataTable) execution.

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.Returned in the task object, there was a connection pool timeout.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Retornado no objeto de tarefa, qualquer erro retornado pelo SQL Server que ocorreu ao abrir a conexão.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Comentários

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

WriteToServerAsync(DataTable, DataRowState, CancellationToken) WriteToServerAsync(DataTable, DataRowState, CancellationToken) 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 DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.The asynchronous version of WriteToServer(DataTable, DataRowState), which copies only rows that match the supplied row state in the supplied DataTable to a destination table specified by the DestinationTableName property of the SqlBulkCopy object.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

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

Parâmetros

table
DataTable DataTable DataTable DataTable

Um DataTable cujas linhas serão copiadas para a tabela de destino.A DataTable whose rows will be copied to the destination table.

rowState
DataRowState DataRowState DataRowState DataRowState

Um valor da enumeração DataRowState.A value from the DataRowState enumeration. Somente as linhas que correspondem ao estado de linha são copiadas para o destino.Only rows matching the row state are copied to the destination.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

A instrução de cancelamento.The cancellation instruction. Um valor None nesse parâmetro torna esse método equivalente a WriteToServerAsync(DataTable).A None value in this parameter makes this method equivalent to WriteToServerAsync(DataTable).

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando WriteToServerAsync(DataTable, DataRowState) várias vezes para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataTable, DataRowState) multiple times for the same instance before task completion.

Chamando WriteToServerAsync(DataTable, DataRowState) e WriteToServer(DataTable, DataRowState) para a mesma instância antes da conclusão da tarefa.Calling WriteToServerAsync(DataTable, DataRowState) and WriteToServer(DataTable, DataRowState) for the same instance before task completion.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataTable, DataRowState).The connection drops or is closed during WriteToServerAsync(DataTable, DataRowState) execution.

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.Returned in the task object, the SqlBulkCopy object was closed during the method execution.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.Returned in the task object, there was a connection pool timeout.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.Returned in the task object, the SqlConnection object is closed before method execution.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Retornado no objeto de tarefa, qualquer erro retornado pelo SQL Server que ocorreu ao abrir a conexão.Returned in the task object, any error returned by SQL Server that occurred while opening the connection.

Comentários

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Aplica-se a