DbDataAdapter.UpdateBatchSize 屬性

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

DbDataAdapter.cs

取得或設定值，其啟用或停用批次處理支援，並指定可於批次中執行的命令數目。

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 所有命令都必須將其 UpdatedRowSource 屬性設定為 None 或 OutputParameters。 否則會擲回例外狀況。

備註

UpdateBatchSize使用 屬性，以從 更新數據源的DataSet變更。 如果數據提供者支援批處理，這可藉由減少往返伺服器的次數來增加應用程式效能。 在 ADO.NET 2.0 中，SQL Server (SqlClient) 和 Oracle (OracleClient) 的 .NET 數據提供者支援此屬性。

執行極大的批次可能會降低效能。 因此，您應該先測試理想的批次大小設定，再實作應用程式。

ArgumentOutOfRangeException如果值設定為小於零的數位，將會擲回 。

另請參閱

• 操作資料 (ADO.NET)
• DbProviderFactory (ADO.NET)
• ADO.NET 概觀 \(部分機器翻譯\)