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 ida e volta para o 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á limite no tamanho do lote. |
| 1 | Desabilita a atualização em lote. |
| >1 | As alterações são enviadas usando lotes de UpdateBatchSize operações de cada vez. |
Ao definir isso como um valor diferente de 1, todos os comandos associados SqlDataAdapter à propriedade UpdatedRowSource devem ser definidos como None ou OutputParameters. Uma exceção é gerada caso contrário.
Comentários
Obtém ou define um valor que habilita ou desabilita o suporte ao processamento em lote e especifica o número de comandos que podem ser executados 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.
