Compartilhar via


SqlBulkCopy.WriteToServerAsync Método

Definição

Sobrecargas

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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.

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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.

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.

WriteToServerAsync(DbDataReader)

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.

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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.

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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

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

cancellationToken
CancellationToken

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

Retornos

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

Exceções

Chamando WriteToServerAsync(DataTable) várias vezes para a mesma instância antes da conclusão da tarefa.

Chamando WriteToServerAsync(DataTable) e WriteToServer(DataTable) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataTable).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a

WriteToServerAsync(DataTable, DataRowState)

A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas linhas que correspondem ao estado de linha fornecido no DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.

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

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

rowState
DataRowState

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

Retornos

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

Exceções

Chamando WriteToServerAsync(DataTable, DataRowState) várias vezes para a mesma instância antes da conclusão da tarefa.

Chamando WriteToServerAsync(DataTable, DataRowState) e WriteToServer(DataTable, DataRowState) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataTable, DataRowState).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataRow[] rows, System.Threading.CancellationToken cancellationToken);
member this.WriteToServerAsync : System.Data.DataRow[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As Task

Parâmetros

rows
DataRow[]

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

cancellationToken
CancellationToken

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

Retornos

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

Exceções

Chamando WriteToServerAsync(DataRow[]) várias vezes para a mesma instância antes da conclusão da tarefa.

Chamando WriteToServerAsync(DataRow[]) e WriteToServer(DataRow[]) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataRow[]).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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

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

cancellationToken
CancellationToken

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

Retornos

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

Aplica-se a

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

A versão assíncrona de WriteToServer(DataTable, DataRowState), que copia apenas linhas que correspondem ao estado de linha fornecido no DataTable fornecido para uma tabela de destino especificada pela propriedade DestinationTableName do objeto SqlBulkCopy.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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

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

rowState
DataRowState

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

cancellationToken
CancellationToken

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

Retornos

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

Exceções

Chamando WriteToServerAsync(DataTable, DataRowState) várias vezes para a mesma instância antes da conclusão da tarefa.

Chamando WriteToServerAsync(DataTable, DataRowState) e WriteToServer(DataTable, DataRowState) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataTable, DataRowState).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a

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.

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

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

Retornos

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

Exceções

Chamando WriteToServerAsync(DataTable) várias vezes para a mesma instância antes da conclusão da tarefa.

Chamando WriteToServerAsync(DataTable) e WriteToServer(DataTable) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataTable).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a

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.

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.

Retornos

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

Exceções

Chamando WriteToServerAsync(DataRow[]) várias vezes para a mesma instância antes da conclusão da tarefa. Chamando WriteToServerAsync(DataRow[]) e WriteToServer(DataRow[]) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(DataRow[]).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a

WriteToServerAsync(DbDataReader)

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.

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

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

Retornos

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

Exceções

Chamando WriteToServerAsync(IDataReader) várias vezes para a mesma instância antes da conclusão da tarefa.

Chamando WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(IDataReader).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

O IDataReader foi fechado antes de o Task preenchido ser retornado.

A conexão associada do IDataReader foi fechada antes de o Task preenchido ser retornado.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a

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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando. As exceções serão relatadas por meio do objeto de tarefa.

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

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

cancellationToken
CancellationToken

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

Retornos

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

Exceções

Chamando WriteToServerAsync(IDataReader) várias vezes para a mesma instância antes da conclusão da tarefa.

Chamando WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(IDataReader).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

O IDataReader foi fechado antes de o Task preenchido ser retornado.

A conexão associada do IDataReader foi fechada antes de o Task preenchido ser retornado.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a

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.

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

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

Retornos

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

Exceções

Chamando WriteToServerAsync(IDataReader) várias vezes para a mesma instância antes da conclusão da tarefa.

Chamando WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) para a mesma instância antes da conclusão da tarefa.

A conexão cai ou é fechada durante a execução do WriteToServerAsync(IDataReader).

Retornado no objeto de tarefa, o objeto SqlBulkCopy foi fechado durante a execução do método.

Retornado no objeto de tarefa, houve um tempo limite do pool de conexão.

Retornado no objeto de tarefa, o objeto SqlConnection foi fechado antes da execução do método.

O IDataReader foi fechado antes de o Task preenchido ser retornado.

A conexão associada do IDataReader foi fechada antes de o Task preenchido ser retornado.

Um SqlBulkCopyColumnOrderHint não especificou um nome de coluna de destino válido.

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

Comentários

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

Aplica-se a