DbDataAdapter.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 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.
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 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 aan de opdracht DbDataAdapter zijn UpdatedRowSource gekoppeld, de eigenschap instellen op Geen of OutputParameters. Er wordt anders een uitzondering gegenereerd.
Opmerkingen
Gebruik de UpdateBatchSize eigenschap om een gegevensbron bij te werken met wijzigingen van een DataSet. Als de gegevensprovider batchverwerking ondersteunt, kan dit de prestaties van de toepassing verbeteren door het aantal retouren naar de server te verminderen. In ADO.NET 2.0 wordt deze eigenschap ondersteund voor de .NET gegevensproviders voor SQL Server (SqlClient) en Oracle (OracleClient).
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.