DbDataAdapter.UpdateBatchSize 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,其啟用或停用批次處理支援,並指定可於批次中執行的命令數目。
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
屬性值
每一批次要處理的資料列數目。
值為 | 效果 |
---|---|
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 概觀 \(部分機器翻譯\)