SqlDataAdapter.UpdateBatchSize Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt het aantal rijen opgehaald of ingesteld dat in elke retour naar de server wordt verwerkt.
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 IntegerWaarde van eigenschap
Het aantal rijen dat per batch moet worden verwerkt.
| Waarde is | Effect |
|---|---|
| 0 | Er is geen limiet voor de batchgrootte. |
| 1 | Schakelt het bijwerken van batches uit. |
| >1 | Wijzigingen worden verzonden met batches bewerkingen UpdateBatchSize tegelijk. |
Wanneer u dit instelt op een andere waarde dan 1, moeten alle opdrachten die zijn gekoppeld aan de SqlDataAdapter eigenschap UpdatedRowSource zijn ingesteld None op of OutputParameters. Er wordt anders een uitzondering gegenereerd.
Opmerkingen
Hiermee haalt u een waarde op die ondersteuning voor batchverwerking inschakelt of uitschakelt en geeft u het aantal opdrachten op dat in een batch kan worden uitgevoerd.
Gebruik de UpdateBatchSize eigenschap om een gegevensbron bij te werken met wijzigingen van een DataSet. Dit kan de prestaties van toepassingen verhogen door het aantal retouren naar de server te verminderen.
Het uitvoeren van een extreem grote batch kan de prestaties verminderen. Daarom moet u testen op de optimale instelling voor batchgrootte voordat u uw toepassing implementeert.
Er ArgumentOutOfRangeException wordt een gegenereerd als de waarde is ingesteld op een getal kleiner dan nul.