SqlDataAdapter.UpdateBatchSize 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

取得或設定每一次來回存取伺服器時所處理的資料列數目。

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

屬性值

Int32

每一批次要處理的資料列數目。

值為	效果
0	批次大小沒有任何限制。
1	停用批次更新。
>1	使用 UpdateBatchSize 作業的批次一次傳送變更。

將此設定為 1 以外的值時，與 SqlDataAdapter 相關聯的所有命令都必須將其 UpdatedRowSource 屬性設定為 None 或 OutputParameters 。 否則會擲回例外狀況。

備註

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

UpdateBatchSize使用 屬性，以從 更新資料來源的 DataSet 變更。 這可藉由減少往返伺服器的數目來增加應用程式效能。

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

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