DbDataAdapter.UpdateBatchSize プロパティ

  • リファレンス

定義

名前空間:
System.Data.Common
アセンブリ:
System.Data.Common.dll
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.dll
ソース:
DbDataAdapter.cs
ソース:
DbDataAdapter.cs
ソース:
DbDataAdapter.cs

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

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

プロパティ値

Int32

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

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

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

注釈

プロパティを UpdateBatchSize 使用して、 からの変更でデータ ソースを DataSet更新します。 データ プロバイダーがバッチ処理をサポートしている場合は、サーバーへのラウンド トリップの数を減らすことで、アプリケーションのパフォーマンスを向上させることができます。 ADO.NET 2.0 では、このプロパティは、SQL Server (SqlClient) と Oracle (OracleClient) の .NET データ プロバイダーでサポートされています。

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

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

適用対象

こちらもご覧ください