Sdílet prostřednictvím

SqlDataAdapter.UpdateBatchSize Vlastnost

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.dll
Sestavení:
System.Data.SqlClient.dll
Balíček:
System.Data.SqlClient v4.8.6

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

Int32

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.

Platí pro

Viz také