DbDataAdapter.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 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.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };public virtual int UpdateBatchSize { get; set; }member this.UpdateBatchSize : int with get, setPublic Overridable 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 ao DbDataAdapter devem ter sua UpdatedRowSource propriedade definida como None ou OutputParameters. Caso contrário, uma exceção será gerada.
Comentários
Use a UpdateBatchSize propriedade para atualizar uma fonte de dados com alterações de um DataSet. Se o provedor de dados der suporte ao processamento em lote, isso poderá aumentar o desempenho do aplicativo reduzindo o número de viagens de ida e volta para o servidor. No ADO.NET 2.0, essa propriedade tem suporte para os provedores de dados do .NET para SQL Server (SqlClient) e Oracle (OracleClient).
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.
