DbDataAdapter.UpdateBatchSize Propriedade

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbDataAdapter.cs

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, set

Public Overridable 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 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.

Confira também

• Manipulando dados (ADO.NET)
• DbProviderFactories (ADO.NET)
• Visão geral do ADO.NET