DbDataAdapter.UpdateBatchSize Vlastnost

  • Reference

Definice

Obor názvů:
System.Data.Common
Sestavení:
System.Data.Common.dll
Sestavení:
System.Data.dll
Sestavení:
netstandard.dll
Zdroj:
DbDataAdapter.cs
Zdroj:
DbDataAdapter.cs
Zdroj:
DbDataAdapter.cs

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, set
Public Overridable Property UpdateBatchSize As Integer

Hodnota vlastnosti

Int32

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.

Platí pro

Viz také