SqlDataAdapter.UpdateBatchSize Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Overrides Property UpdateBatchSize As IntegerValor da propriedade
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.