DbDataAdapter.UpdateBatchSize Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
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.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };public virtual int UpdateBatchSize { get; set; }member this.UpdateBatchSize : int with get, setPublic Overridable Property UpdateBatchSize As IntegerTulajdonság értéke
A feldolgozandó sorok száma kötegenként.
| 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, a hozzá tartozó DbDataAdapter összes parancsnak UpdatedRowSource vagy OutputParameters értékre kell állítania a tulajdonságát. Ellenkező esetben kivételt ad ki a rendszer.
Megjegyzések
UpdateBatchSize A tulajdonság használatával frissíthet egy adatforrást DataSetegy . Ha az adatszolgáltató támogatja a kötegelt feldolgozást, 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. Az ADO.NET 2.0-s verzióban ez a tulajdonság az SQL Server (SqlClient) és az Oracle (OracleClient) .NET adatszolgáltatói számára támogatott.
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.
A ArgumentOutOfRangeException rendszer egy nullánál kisebb számra állítja be az értéket.
