DbDataAdapter.UpdateBatchSize Propriedade

Definição

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.Gets or sets a value that enables or disables batch processing support, and specifies the number of commands that can be executed in a batch.

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.The number of rows to process per batch.

O valor éValue is EfeitoEffect
00 Não há nenhum limite para o tamanho do lote.There is no limit on the batch size.
11 Desabilita a atualização em lote.Disables batch updating.
> uma> 1 As alterações são enviadas usando lotes de operações UpdateBatchSize de uma vez.Changes are sent using batches of UpdateBatchSize operations at a time.

Ao definir isso com um valor diferente de 1, todos os comandos associados ao DbDataAdapter devem ter sua UpdatedRowSource propriedade definida como None ou OutputParameters.When setting this to a value other than 1, all the commands associated with the DbDataAdapter must have their UpdatedRowSource property set to None or OutputParameters. Caso contrário, uma exceção será gerada.An exception will be thrown otherwise.

Comentários

Use a UpdateBatchSize propriedade para atualizar uma fonte de dados com alterações de um DataSet .Use the UpdateBatchSize property to update a data source with changes from a DataSet. Se o provedor de dados oferecer suporte ao processamento em lotes, isso poderá aumentar o desempenho do aplicativo, reduzindo o número de viagens de ida e volta ao servidor.If the data provider supports batch processing, this can increase application performance by reducing the number of round-trips to the server. No ADO.NET 2,0, essa propriedade tem suporte para os provedores de dados .NET para SQL Server (SqlClient) e Oracle (OracleClient).In ADO.NET 2.0, this property is supported for the .NET data providers for SQL Server (SqlClient) and Oracle (OracleClient).

Executar um lote extremamente grande pode diminuir o desempenho.Executing an extremely large batch could decrease performance. Portanto, você deve testar para verificar qual é a melhor configuração de tamanho de lote antes de implementar seu aplicativo.Therefore, you should test for the optimum batch size setting before implementing your application.

Um ArgumentOutOfRangeException será gerado se o valor for definido como um número menor que zero.An ArgumentOutOfRangeException will be thrown if the value is set to a number less than zero.

Aplica-se a