SqlDataAdapter.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í počet řádků, které jsou zpracovány v každé odezvě na server.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };public override int UpdateBatchSize { get; set; }member this.UpdateBatchSize : int with get, setPublic Overrides Property UpdateBatchSize As IntegerHodnota vlastnosti
Počet řádků, které se mají zpracovat podle dávky
| 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, všechny příkazy přidružené SqlDataAdapter k musí mít vlastnost UpdatedRowSource nastavena na None hodnotu nebo OutputParameters. V opačném případě dojde k výjimce.
Poznámky
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.
UpdateBatchSize Vlastnost slouží k aktualizaci zdroje dat se změnami z objektu DataSet. To může zvýšit výkon aplikace snížením počtu odezvy na server.
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.
