DbBatch Klasse

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Stellt einen Batch von Befehlen dar, der für eine Datenquelle in einem einzelnen Roundtrip ausgeführt werden kann. 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

Object

DbBatch

Implementiert

IAsyncDisposable IDisposable

Hinweise

Die genaue Semantik der Batchausführung variiert zwischen ADO.NET Anbietern, insbesondere bei der Fehlerbehandlung. Wenn möglich, wird empfohlen, dass ein Fehler in einem Befehl innerhalb des Batches den Batch sofort beendet, alle nachfolgenden Befehle überspringt und bereits ausgeführte Befehle zurückrollt. Dieses Verhalten wird jedoch möglicherweise nicht datenbankübergreifend unterstützt. Lesen Sie 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	Ruft die von diesem DbConnection verwendete DbBatch ab oder legt diese fest.
DbBatchCommands	Ruft bei Überschreibung in einer abgeleiteten Klasse die Sammlung von DbBatchCommand-Objekten ab.
DbConnection	Ruft bei Überschreibung in einer abgeleiteten Klasse die DbConnection-Eigenschaft ab, die für diesen DbBatch verwendet wird.
DbTransaction	Ruft bei Überschreibung in einer abgeleiteten Klasse die DbTransaction ab, in der dieses DbBatch-Objekt ausgeführt wird, oder legt diese Transaktion fest.
Timeout	Ruft die Wartezeit (in Sekunden) ab, bevor der Versuch, den Batch auszuführen, beendet und ein Fehler generiert wird, oder legt diese fest.
Transaction	Ruft die DbTransaction ab, in der dieses DbBatch-Objekt ausgeführt wird, oder legt sie fest.

Methoden

Cancel()	Versucht, die Ausführung eines DbBatchabzubrechen.
CreateBatchCommand()	Erstellt eine neue Instanz eines DbBatchCommand-Objekts.
CreateDbBatchCommand()	Erstellt bei Überschreibung in einer abgeleiteten Klasse eine neue Instanz eines DbBatchCommand-Objekts.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
DisposeAsync()	Diposes das Batchobjekt asynchron.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)	Führt beim Überschreiben in einer abgeleiteten Klasse den Batch für seine Verbindung aus, und gibt eine DbDataReader zurück, 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. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern. Implementierungen können diese Anforderung ignorieren.
ExecuteNonQuery()	Führt den Batch für sein Verbindungsobjekt aus, und gibt die Gesamtzahl der betroffenen Zeilen für alle Batchbefehle zurück.
ExecuteNonQueryAsync(CancellationToken)	Dies ist die asynchrone Version von ExecuteNonQuery(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.
ExecuteReader(CommandBehavior)	Führt den Batch für seine 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 , ExecuteReaderdie den Batch für seine 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 , ExecuteReaderdie den Batch für seine 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()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Prepare()	Erstellt eine vorbereitete (oder kompilierte) Version des Batches oder der einzelnen Befehle für die Datenquelle.
PrepareAsync(CancellationToken)	Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Batches oder der einzelnen Befehle für die Datenquelle.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie Wartezeiten auf die Aufgaben angewandt werden, die von einem asynchronen verwerfbaren Element zurückgegeben werden.