SqlDataAdapter.UpdateBatchSize Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Obtém ou define o número de linhas que são processadas em cada viagem de ida e volta ao servidor.

public:
 virtual property int UpdateBatchSize { int get(); void set(int value); };

public override int UpdateBatchSize { get; set; }

member this.UpdateBatchSize : int with get, set

Public Overrides Property UpdateBatchSize As Integer

Valor da propriedade

Int32

O número de linhas a serem processadas por lote.

O valor é	Efeito
0	Não há nenhum limite para o tamanho do lote.
1	Desabilita a atualização em lote.
>1	As alterações são enviadas usando lotes de operações UpdateBatchSize de uma vez.

Ao definir isso como um valor diferente de 1, todos os comandos associados SqlDataAdapter ao precisam ter sua propriedade UpdatedRowSource definida como None ou OutputParameters. Do contrário, uma exceção será gerada.

Comentários

Obtém ou define um valor que habilita ou desabilita o suporte ao processamento de lote e especifica o número de comandos que podem ser executadas em um lote.

Use a UpdateBatchSize propriedade para atualizar uma fonte de dados com alterações de um DataSet. Isso pode aumentar o desempenho do aplicativo reduzindo o número de viagens de ida e volta para o servidor.

Executar um lote extremamente grande pode diminuir o desempenho. Portanto, você deve testar para verificar qual é a melhor configuração de tamanho de lote antes de implementar seu aplicativo.

Um ArgumentOutOfRangeException será gerado se o valor for definido como um número menor que zero.