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ém 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, set
Public Overrides Property UpdateBatchSize As Integer
Hodnota 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 odesílají pomocí dávek UpdateBatchSize operací najednou. |
Pokud tuto hodnotu nastavíte na jinou hodnotu než 1, musí mít všechny příkazy přidružené k objektu SqlDataAdapter vlastnost UpdatedRowSource nastavenou 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 Pomocí vlastnosti aktualizujte zdroj dat o změny z objektu DataSet. To může zvýšit výkon aplikace snížením počtu odezvy na server.
Spuštění extrémně velké dávky může snížit výkon. Proto byste měli před implementací aplikace otestovat optimální velikost dávky.
Vyvolá ArgumentOutOfRangeException se, pokud je hodnota nastavená na číslo menší než nula.