OracleDataAdapter.UpdateBatchSize プロパティ

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

バッチ処理サポートを有効にするかどうか、および、1 回のバッチで実行可能なコマンド数を指定する値を取得または設定します。

public:
 virtual property int UpdateBatchSize { int get(); void set(int value); };

public override int UpdateBatchSize { get; set; }

member this.UpdateBatchSize : int with get, set

Public Overrides Property UpdateBatchSize As Integer

Int32

バッチごとに処理される行数。

値:	動作
0	バッチのサイズに制限はありません。
1	バッチ更新を無効にします。
> 1	一度に送信される変更内容は UpdateBatchSize のバッチサイズに基づきます。

1 を超える値を設定する場合、OracleDataAdapter に関連付けられたすべてのコマンドは、それぞれの UpdatedRowSource プロパティに None または OutputParameters が設定されている必要があります。それ以外の場合は、例外がスローされます。

プロパティを UpdateBatchSize 使用して、からの変更でデータソースを DataSet更新します。これにより、サーバーへのラウンドトリップの数を減らすことで、アプリケーションのパフォーマンスを向上させることができます。

サイズの大きいバッチを実行すると、パフォーマンスが低下する可能性があります。そのため、アプリケーションを実装する前に、最適なバッチサイズ設定をテストする必要があります。

ArgumentOutOfRangeException値が 0 未満の数値に設定されている場合は、がスローされます。