SqlDataAdapter.UpdateBatchSize プロパティ

定義

サーバーとの 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

プロパティ値

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

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

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

注釈

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

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

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

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

適用対象