SqlDataAdapter.UpdateBatchSize Tulajdonság

Definíció

Névtér:
System.Data.SqlClient
Szerelvény:
System.Data.dll
Forrás:
System.Data.SqlClient.notsupported.cs

Lekéri vagy beállítja a kiszolgálóra való minden oda-visszaút során feldolgozott sorok számát.

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

Tulajdonság értéke

Int32

A kötegenként feldolgozandó sorok száma.

Az érték a Hatás
0 A köteg méretének nincs korlátja.
1 Letiltja a kötegfrissítést.
>1 A módosításokat egyszerre több művelet kötegével küldi UpdateBatchSize el a rendszer.

Ha ezt nem 1 értékre állítja, az ahhoz társított SqlDataAdapter összes parancsnak az UpdatedRowSource tulajdonságot kell beállítania None vagy OutputParameters. Ellenkező esetben kivétel történik.

Megjegyzések

Lekéri vagy beállít egy olyan értéket, amely engedélyezi vagy letiltja a kötegelt feldolgozás támogatását, és megadja a kötegben végrehajtható parancsok számát.

UpdateBatchSize A tulajdonság használatával frissíthet egy adatforrást DataSetegy . Ez növelheti az alkalmazás teljesítményét a kiszolgálóra irányuló ciklikus utak számának csökkentésével.

Egy rendkívül nagy köteg végrehajtása csökkentheti a teljesítményt. Ezért az alkalmazás implementálása előtt tesztelnie kell az optimális kötegméret-beállítást.

Ha ArgumentOutOfRangeException az érték nullánál kisebb számra van beállítva, akkor a rendszer egy dobott értéket ad vissza.

A következőre érvényes:

Lásd még