Teilen über


DbBatch Klasse

Definition

Stellt einen Batch von Befehlen dar, die für eine Datenquelle in einem einzelnen Roundtrip ausgeführt werden können. Stellt eine Basisklasse für datenbankspezifische Klassen bereit, die Befehlsbatches darstellen.

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
Vererbung
DbBatch
Implementiert

Hinweise

Die genaue Semantik der Batchausführung variiert bei ADO.NET Anbietern, insbesondere bei der Fehlerbehandlung. Wenn möglich, wird empfohlen, dass ein Fehler in einem Befehl innerhalb des Batches sofort den Batch beendet, alle nachfolgenden Befehle überspringt und bereits ausgeführte Rollbackbefehle zurückgibt. Dieses Verhalten wird jedoch möglicherweise nicht in Datenbanken unterstützt; wenden Sie sich an die Dokumentation Ihres ADO.NET Anbieters.

Konstruktoren

DbBatch()

Initialisiert eine neue Instanz der DbBatch Klasse.

Eigenschaften

BatchCommands

Ruft die Auflistung von DbBatchCommand -Objekten ab.

Connection

Dient zum Abrufen oder Festlegen der von diesem DbBatchverwendeten DbConnection.

DbBatchCommands

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Auflistung von DbBatchCommand Objekten ab.

DbConnection

Ruft die von dieser DbBatchverwendete DbConnection ab, wenn sie in einer abgeleiteten Klasse überschrieben wird, oder legt diese fest.

DbTransaction

Ruft beim Überschreiben in einer abgeleiteten Klasse die DbTransaction ab, in der dieses DbBatch-Objekt ausgeführt wird, oder legt diesen fest.

Timeout

Ruft die Wartezeit (in Sekunden) ab, bevor der Versuch beendet wird, den Batch auszuführen und einen Fehler zu generieren, oder legt diese fest.

Transaction

Dient zum Abrufen oder Festlegen des DbTransaction, in dem dieses DbBatch-Objekt ausgeführt wird.

Methoden

Cancel()

Versucht, die Ausführung eines DbBatchabzubrechen.

CreateBatchCommand()

Erstellt eine neue Instanz eines DbBatchCommand-Objekts.

CreateDbBatchCommand()

Wenn eine abgeleitete Klasse überschrieben wird, wird eine neue Instanz eines DbBatchCommand-Objekts erstellt.

Dispose()

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind.

DisposeAsync()

Das Batchobjekt wird asynchron eingetaucht.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Batch mit seiner Verbindung ausgeführt, wodurch eine DbDataReader zurückgegeben wird, die für den Zugriff auf die Ergebnisse verwendet werden kann.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Anbieter sollten diese Methode implementieren, um eine nicht standardmäßige Implementierung für ExecuteReader Überladungen bereitzustellen.

Die Standardimplementierung ruft die synchrone ExecuteReader()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

Diese Methode akzeptiert ein Abbruchtoken, mit dem der Vorgang frühzeitig abgebrochen werden kann. Implementierungen können diese Anforderung ignorieren.

ExecuteNonQuery()

Führt den Batch mit seinem Verbindungsobjekt aus, wobei die Gesamtanzahl der Zeilen zurückgegeben wird, die für alle Batchbefehle betroffen sind.

ExecuteNonQueryAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteNonQuery(). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional ignoriert werden.

Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

Rufen Sie erst andere Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.

ExecuteReader(CommandBehavior)

Führt den Batch mit seiner Verbindung aus und gibt eine DbDataReader zurück, die für den Zugriff auf die Ergebnisse verwendet werden kann.

ExecuteReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteReader, die den Batch mit seiner Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Eine asynchrone Version von ExecuteReader, die den Batch mit seiner Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann.

ExecuteScalar()

Führt den Batch aus und gibt die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurück. Alle anderen Spalten, Zeilen und Resultsets werden ignoriert.

ExecuteScalarAsync(CancellationToken)

Eine asynchrone Version von ExecuteScalar(), die den Batch ausführt und die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurückgibt. Alle anderen Spalten, Zeilen und Resultsets werden ignoriert.

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
Prepare()

Erstellt eine vorbereitete (oder kompilierte) Version des Batches oder jedes seiner Befehle in der Datenquelle.

PrepareAsync(CancellationToken)

Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Batches oder jeder seiner Befehle in der Datenquelle.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird.

Gilt für: