SqlDataAdapter.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 以外の値に設定する場合、に関連付SqlDataAdapterけられているすべてのコマンドで、UpdatedRowSource プロパティをまたは OutputParametersに設定するNone必要があります。それ以外の場合は、例外がスローされます。

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

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

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

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