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á povoluje nebo zakazuje 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 v dávce.
| 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 nastavíte hodnotu na jinou hodnotu než 1, všechny příkazy přidružené k tomuto parametru DbDataAdapter musí mít vlastnost UpdatedRowSource nastavenou na Hodnotu None nebo OutputParameters. Jinak dojde k výjimce.
Poznámky
UpdateBatchSize Pomocí vlastnosti aktualizujte zdroj dat pomocí změn 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 je tato vlastnost podporovaná pro zprostředkovatele dat .NET pro SQL Server (SqlClient) a Oracle (OracleClient).
Spuštění extrémně velké dávky může snížit výkon. Proto byste měli před implementací aplikace otestovat nastavení optimální velikosti dávky.
Pokud ArgumentOutOfRangeException je hodnota nastavená na číslo menší než nula, vyvolá se hodnota.
