DbDataAdapter.UpdateBatchSize プロパティ

.NET Framework クラス ライブラリ リファレンス

DbDataAdapter.UpdateBatchSize プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 UpdateBatchSize As Integer

Visual Basic (使用法)

Dim instance As DbDataAdapter
Dim value As Integer

value = instance.UpdateBatchSize

instance.UpdateBatchSize = value

C#

public virtual int UpdateBatchSize { get;
 set; }

C++

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

J#

/** @property */
public int get_UpdateBatchSize ()

/** @property */
public void set_UpdateBatchSize (int
 value)

JScript

public function get UpdateBatchSize
 () : int

public function set UpdateBatchSize
 (value : int)

プロパティ値
バッチごとに処理される行数。

値	影響
0	DbDataAdapter は、サーバーが処理可能な最大バッチ サイズを使用します。
1	バッチ更新を無効にします。
> 1	一度に送信される変更内容は UpdateBatchSize のバッチ サイズに基づきます。

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

解説

DataSet からの変更内容でデータ ソースを更新するには、UpdateBatchSize プロパティを使用します。データ プロバイダがバッチ処理をサポートしている場合、これにより、サーバーへのラウンドトリップ数が減り、アプリケーションのパフォーマンスが向上します。ADO.NET 2.0 では、SQL Server (SqlClient) および Oracle (OracleClient) 用の .NET データ プロバイダでこのプロパティがサポートされています。詳細については、「DataAdapter によるバッチ更新の実行」を参照してください。

ゼロより小さい値を設定した場合、ArgumentOutOfRangeException がスローされます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間