SqlDataAdapter.UpdateBatchSize Propriedade

  • Referência

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.6

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.

Aplica-se a

Confira também