DbDataAdapter.UpdateBatchSize Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu, která povolí nebo zakáže podporu dávkového zpracování a určuje počet příkazů, které lze spustit v dávce.
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 IntegerHodnota vlastnosti
Počet řádků, které se mají zpracovat na dávku.
| Hodnota je | Účinek |
|---|---|
| 0 | Velikost dávky není nijak omezena. |
| 1 | Zakáže dávkovou aktualizaci. |
| > 1 | Změny se posílají pomocí dávek UpdateBatchSize operací najednou. |
Při nastavení na jinou hodnotu než 1 musí mít UpdatedRowSource všechny příkazy přidružené k DbDataAdapter této vlastnosti nastavenou na None nebo OutputParameters. Jinak dojde k výjimce.
Poznámky
UpdateBatchSize Vlastnost slouží k aktualizaci zdroje dat se změnami z objektu DataSet. Pokud poskytovatel dat podporuje dávkové zpracování, může to zvýšit výkon aplikace snížením počtu odezvy na server. V ADO.NET 2.0 se tato vlastnost podporuje pro poskytovatele dat .NET pro SQL Server (SqlClient) a Oracle (OracleClient).
Provedení extrémně velké dávky může snížit výkon. Proto byste měli před implementací aplikace otestovat optimální nastavení velikosti dávky.
Vyvolá ArgumentOutOfRangeException se, pokud je hodnota nastavená na číslo menší než nula.
