DbBatch Klasse

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Stellt einen Batch von Befehlen dar, die für eine Datenquelle in einer einzelnen Rundreise 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

Object

DbBatch

Implementiert

IAsyncDisposable IDisposable

Hinweise

Die genaue Semantik der Batchausführung variiert über ADO.NET Anbieter, insbesondere um die Fehlerbehandlung. Wenn möglich, empfiehlt es sich, einen Fehler in einem Befehl innerhalb des Batchs sofort zu beenden, alle nachfolgenden Befehle zu überspringen und Befehle zurückzugeben, die bereits ausgeführt wurden. Dieses Verhalten wird jedoch möglicherweise nicht über Datenbanken hinweg 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	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 oder legt sie fest, bevor der Versuch beendet wird, den Batch auszuführen und einen Fehler zu generieren.
Transaction	Ruft die DbTransaction ab, in der dieses DbBatch-Objekt ausgeführt wird, oder legt sie fest.

Methoden

Cancel()	Versucht, die Ausführung einer DbBatch.
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()	Die Batchobjekt wird asynchron getaucht.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt werden, wird der Batch mit seiner Verbindung ausgeführt, um DbDataReader auf die Ergebnisse zuzugreifen.
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 gegen sein Verbindungsobjekt aus, und gibt die Gesamtanzahl der Zeilen zurück, die über alle Batchbefehle betroffen sind.
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 gegen seine Verbindung aus, und gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.
ExecuteReaderAsync(CancellationToken)	Eine asynchrone Version von ExecuteReader, die den Batch gegen seine Verbindung ausführt, gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Eine asynchrone Version von ExecuteReader, die den Batch gegen seine Verbindung ausführt, gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.
ExecuteScalar()	Führt den Batch aus und gibt die erste Spalte der ersten Zeile im ersten zurückgegebenen Ergebnissatz 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 Ergebnissatz zurückgibt. Alle anderen Spalten, Zeilen und Ergebnissätze 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 Batchs oder der einzelnen Befehle auf der Datenquelle.
PrepareAsync(CancellationToken)	Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Batchs oder der einzelnen Befehle auf der 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.