DbBatch Klas

Definitie

Naamruimte:
System.Data.Common
Assembly:
System.Data.Common.dll
Bron:
DbBatch.cs
Bron:
DbBatch.cs
Bron:
DbBatch.cs
Bron:
DbBatch.cs
Bron:
DbBatch.cs

Vertegenwoordigt een reeks opdrachten die in één retour kunnen worden uitgevoerd op een gegevensbron. Biedt een basisklasse voor databasespecifieke klassen die opdrachtbatches vertegenwoordigen.

public ref class DbBatch abstract : IAsyncDisposable, IDisposable
public abstract class DbBatch : IAsyncDisposable, IDisposable
type DbBatch = class
    interface IDisposable
    interface IAsyncDisposable
Public MustInherit Class DbBatch
Implements IAsyncDisposable, IDisposable
Overname
Object
DbBatch
Implementeringen
IAsyncDisposable IDisposable

Opmerkingen

De precieze semantiek van batchuitvoering verschilt per ADO.NET providers, met name rond foutafhandeling. Indien mogelijk wordt aanbevolen dat een fout in een opdracht in de batch de batch onmiddellijk beëindigt, alle volgende opdrachten overslaat en opdrachten terugdraait die al zijn uitgevoerd. Dit gedrag wordt echter mogelijk niet ondersteund in databases; raadpleeg de documentatie van uw ADO.NET provider.

Constructors

Name Description
DbBatch()

Initialiseert een nieuw exemplaar van de DbBatch klasse.

Eigenschappen

Name Description
BatchCommands

Hiermee haalt u de verzameling DbBatchCommand objecten op.
Connection

Hiermee haalt u het DbConnection gebruikte bestand op of stelt u deze DbBatchin.
DbBatchCommands

Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de verzameling DbBatchCommand objecten op.
DbConnection

Wanneer deze wordt overschreven in een afgeleide klasse, haalt of stelt u de DbConnection gebruikte klasse in DbBatch.
DbTransaction

Wanneer deze wordt overschreven in een afgeleide klasse, haalt of stelt u het DbTransaction object in waarin dit DbBatch object wordt uitgevoerd.
Timeout

Haalt de wachttijd (in seconden) op of stelt deze in voordat de poging om de batch uit te voeren wordt beëindigd en een fout wordt gegenereerd.
Transaction

Hiermee haalt u het DbTransaction object op of stelt u het DbBatch object in.

Methoden

Name Description
Cancel()

Pogingen om de uitvoering van een DbBatch.
CreateBatchCommand()

Hiermee maakt u een nieuw exemplaar van een DbBatchCommand object.
CreateDbBatchCommand()

Wanneer deze wordt overschreven in een afgeleide klasse, maakt u een nieuw exemplaar van een DbBatchCommand object.
Dispose()

Voert door de toepassing gedefinieerde taken uit die zijn gekoppeld aan het vrijmaken, vrijgeven of opnieuw instellen van onbeheerde resources.
DisposeAsync()

Het batchobject wordt asynchroon verwijderd.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
ExecuteDbDataReader(CommandBehavior)

Wanneer deze wordt overschreven in een afgeleide klasse, voert u de batch uit op basis van de verbinding, waardoor een DbDataReader batch kan worden geretourneerd die kan worden gebruikt voor toegang tot de resultaten.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Providers moeten deze methode implementeren om een niet-standaard implementatie te bieden voor ExecuteReader overbelastingen.

De standaardimplementatie roept de synchrone ExecuteReader() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die door ExecuteReader worden gegenereerd, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering.

Deze methode accepteert een annuleringstoken dat kan worden gebruikt om de bewerking vroeg te annuleren. Implementaties kunnen deze aanvraag negeren.
ExecuteNonQuery()

Voert de batch uit op het bijbehorende verbindingsobject en retourneert het totale aantal rijen dat is beïnvloed door alle batchopdrachten.
ExecuteNonQueryAsync(CancellationToken)

Dit is de asynchrone versie van ExecuteNonQuery(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden genegeerd.

De standaardimplementatie roept de synchrone ExecuteNonQuery() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die worden gegenereerd ExecuteNonQuery() door, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering.

Roep geen andere methoden en eigenschappen van het DbCommand object aan totdat de geretourneerde taak is voltooid.
ExecuteReader(CommandBehavior)

Voert de batch uit op basis van de verbinding en retourneert een DbDataReader die kan worden gebruikt om toegang te krijgen tot de resultaten.
ExecuteReaderAsync(CancellationToken)

Een asynchrone versie van , die de batch uitvoert op basis van ExecuteReaderde verbinding, retourneert een DbDataReader versie die kan worden gebruikt voor toegang tot de resultaten.
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Een asynchrone versie van , die de batch uitvoert op basis van ExecuteReaderde verbinding, retourneert een DbDataReader versie die kan worden gebruikt voor toegang tot de resultaten.
ExecuteScalar()

Voert de batch uit en retourneert de eerste kolom van de eerste rij in de eerste geretourneerde resultatenset. Alle andere kolommen, rijen en resultatensets worden genegeerd.
ExecuteScalarAsync(CancellationToken)

Een asynchrone versie van ExecuteScalar(), waarmee de batch wordt uitgevoerd en de eerste kolom van de eerste rij in de eerste geretourneerde resultatenset wordt geretourneerd. Alle andere kolommen, rijen en resultatensets worden genegeerd.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
Prepare()

Hiermee maakt u een voorbereide (of gecompileerde) versie van de batch of van elk van de bijbehorende opdrachten op de gegevensbron.
PrepareAsync(CancellationToken)

Asynchroon maakt u een voorbereide (of gecompileerde) versie van de batch of van elk van de bijbehorende opdrachten op de gegevensbron.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Extensiemethoden

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Hiermee configureert u hoe wacht op de taken die worden geretourneerd op basis van een asynchroon wegwerp, worden uitgevoerd.

Van toepassing op