DbBatch Klass

Definition

Namnområde:
System.Data.Common
Sammansättning:
System.Data.Common.dll
Källa:
DbBatch.cs
Källa:
DbBatch.cs
Källa:
DbBatch.cs
Källa:
DbBatch.cs
Källa:
DbBatch.cs

Representerar en batch med kommandon som kan köras mot en datakälla i en enda tur och retur-resa. Tillhandahåller en basklass för databasspecifika klasser som representerar kommandobatch.

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
Arv
Object
DbBatch
Implementeringar
IAsyncDisposable IDisposable

Kommentarer

Den exakta semantiken för batchkörning varierar mellan ADO.NET providrar, särskilt kring felhantering. När det är möjligt rekommenderar vi att ett fel i ett kommando i batchen omedelbart avslutar batchen, hoppar över alla efterföljande kommandon och återställer kommandon som redan har körts. Det här beteendet kanske dock inte stöds i databaser. Läs dokumentationen för din ADO.NET leverantör.

Konstruktorer

Name Description
DbBatch()

Initierar en ny instans av DbBatch klassen.

Egenskaper

Name Description
BatchCommands

Hämtar samlingen med DbBatchCommand objekt.
Connection

Hämtar eller anger den DbConnection som används av den här DbBatch.
DbBatchCommands

När du åsidosättas i en härledd klass hämtar du samlingen med DbBatchCommand objekt.
DbConnection

När du åsidosättas i en härledd klass hämtar eller anger du den DbConnection som används av den här DbBatch.
DbTransaction

När det åsidosättas i en härledd klass hämtar eller anger du DbTransaction inom vilken det här DbBatch objektet körs.
Timeout

Hämtar eller anger väntetiden (i sekunder) innan försöket att köra batchen avslutas och ett fel genereras.
Transaction

Hämtar eller anger inom DbTransaction vilken det här DbBatch objektet körs.

Metoder

Name Description
Cancel()

Försök att avbryta körningen av en DbBatch.
CreateBatchCommand()

Skapar en ny instans av ett DbBatchCommand objekt.
CreateDbBatchCommand()

När den åsidosättas i en härledd klass skapar en ny instans av ett DbBatchCommand objekt.
Dispose()

Utför programdefinierade uppgifter som är associerade med att frigöra, frigöra eller återställa ohanterade resurser.
DisposeAsync()

Tar bort batchobjektet asynkront.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
ExecuteDbDataReader(CommandBehavior)

När den åsidosätts i en härledd klass kör den batchen mot anslutningen och returnerar en DbDataReader som kan användas för att komma åt resultaten.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Leverantörer bör implementera den här metoden för att tillhandahålla en icke-standardimplementering för ExecuteReader överlagringar.

Standardimplementeringen anropar den synkrona ExecuteReader() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteReader kommuniceras via den returnerade egenskapen Aktivitetsfel.

Den här metoden accepterar en annulleringstoken som kan användas för att begära att åtgärden avbryts tidigt. Implementeringar kan ignorera den här begäran.
ExecuteNonQuery()

Kör batchen mot dess anslutningsobjekt och returnerar det totala antalet rader som påverkas för alla batchkommandon.
ExecuteNonQueryAsync(CancellationToken)

Det här är den asynkrona versionen av ExecuteNonQuery(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras.

Standardimplementeringen anropar den synkrona ExecuteNonQuery() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteNonQuery() kommer att kommuniceras via den returnerade egenskapen Aktivitetsfel.

Anropa inte andra metoder och egenskaper för DbCommand objektet förrän den returnerade aktiviteten har slutförts.
ExecuteReader(CommandBehavior)

Kör batchen mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.
ExecuteReaderAsync(CancellationToken)

En asynkron version av ExecuteReader, som kör batchen mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.
ExecuteReaderAsync(CommandBehavior, CancellationToken)

En asynkron version av ExecuteReader, som kör batchen mot dess anslutning och returnerar en DbDataReader som kan användas för att komma åt resultaten.
ExecuteScalar()

Kör batchen och returnerar den första kolumnen i den första raden i den första returnerade resultatuppsättningen. Alla andra kolumner, rader och resultatuppsättningar ignoreras.
ExecuteScalarAsync(CancellationToken)

En asynkron version av ExecuteScalar(), som kör batchen och returnerar den första kolumnen på den första raden i den första returnerade resultatuppsättningen. Alla andra kolumner, rader och resultatuppsättningar ignoreras.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Prepare()

Skapar en förberedd (eller kompilerad) version av batchen, eller av vart och ett av dess kommandon, på datakällan.
PrepareAsync(CancellationToken)

Asynkront skapar en förberedd (eller kompilerad) version av batchen, eller av vart och ett av dess kommandon, på datakällan.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Tilläggsmetoder

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Konfigurerar hur väntar på de uppgifter som returneras från en asynkron disponibel ska utföras.

Gäller för