SqlDataAdapter.UpdateBatchSize Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o número de linhas que são processadas em cada 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 de Propriedade
O número de linhas a processar por lote.
| O valor é | Efeito |
|---|---|
| 0 | Não há limite para o tamanho do lote. |
| 1 | Desativa a atualização por lote. |
| >1 | As alterações são enviadas usando lotes de UpdateBatchSize operações de cada vez. |
Ao definir isto para um valor diferente de 1, todos os comandos associados a eles SqlDataAdapter têm de ter a propriedade UpdatedRowSource definida como None ou OutputParameters. Caso contrário, é feita uma exceção.
Observações
Recebe ou define um valor que permite ou desativa o suporte ao processamento por lote, e especifica o número de comandos que podem ser executados num batch.
Use a UpdateBatchSize propriedade para atualizar uma fonte de dados com alterações a partir de um DataSetarquivo . Isto pode aumentar o desempenho da aplicação ao reduzir o número de idas e voltas ao servidor.
A execução de um lote extremamente grande pode diminuir o desempenho. Portanto, você deve testar a configuração de tamanho de lote ideal antes de implementar seu aplicativo.
Um ArgumentOutOfRangeException é lançado se o valor for definido para um número inferior a zero.