DbBatch Klasa

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DbBatch.cs

Reprezentuje partię poleceń, które można wykonać względem źródła danych w jednej rundzie. Udostępnia klasę bazową dla klas specyficznych dla bazy danych, które reprezentują partie poleceń.

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

Dziedziczenie

Object

DbBatch

Implementuje

IAsyncDisposable IDisposable

Uwagi

Dokładna semantyka wykonywania wsadowego różni się w zależności od dostawców ADO.NET, szczególnie w przypadku obsługi błędów. Jeśli to możliwe, zaleca się, aby błąd w poleceniu w partii natychmiast przerwał partię, pominąć wszystkie kolejne polecenia i wycofać polecenia, które już wykonane. Jednak takie zachowanie może nie być obsługiwane w bazach danych; zapoznaj się z dokumentacją dostawcy ADO.NET.

Konstruktory

DbBatch()

Inicjuje nowe wystąpienie klasy DbBatch.

Właściwości

BatchCommands	Pobiera kolekcję obiektów DbBatchCommand.
Connection	Pobiera lub ustawia DbConnection używane przez ten DbBatch.
DbBatchCommands	Po zastąpieniu w klasie pochodnej pobiera kolekcję obiektów DbBatchCommand.
DbConnection	Po zastąpieniu w klasie pochodnej pobiera lub ustawia DbConnection używane przez tę DbBatch.
DbTransaction	Po przesłonięciu w klasie pochodnej pobiera lub ustawia DbTransaction, w której jest wykonywany ten obiekt DbBatch.
Timeout	Pobiera lub ustawia czas oczekiwania (w sekundach) przed zakończeniem próby wykonania partii i wygenerowania błędu.
Transaction	Pobiera lub ustawia DbTransaction, w którym jest wykonywany ten obiekt DbBatch.

Metody

Cancel()	Próbuje anulować wykonywanie DbBatch.
CreateBatchCommand()	Tworzy nowe wystąpienie obiektu DbBatchCommand.
CreateDbBatchCommand()	Po zastąpieniu w klasie pochodnej tworzy nowe wystąpienie obiektu DbBatchCommand.
Dispose()	Wykonuje zadania zdefiniowane przez aplikację skojarzone z zwalnianiem, wydawaniem lub resetowaniem niezarządzanych zasobów.
DisposeAsync()	Asynchronicznie dzieli obiekt wsadowy.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)	Gdy przesłonięta w klasie pochodnej, wykonuje partię względem połączenia, zwracając DbDataReader, która może służyć do uzyskiwania dostępu do wyników.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Dostawcy powinni zaimplementować tę metodę, aby zapewnić implementację inną niż domyślna dla przeciążeń ExecuteReader. Domyślna implementacja wywołuje synchroniczną metodę ExecuteReader() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez element ExecuteReader będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. Ta metoda akceptuje token anulowania, który może służyć do żądania wcześniejszego anulowania operacji. Implementacje mogą ignorować to żądanie.
ExecuteNonQuery()	Wykonuje partię względem obiektu połączenia, zwracając całkowitą liczbę wierszy, których dotyczy problem we wszystkich poleceniach wsadowych.
ExecuteNonQueryAsync(CancellationToken)	Jest to asynchroniczna wersja ExecuteNonQuery(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany. Domyślna implementacja wywołuje synchroniczną metodę ExecuteNonQuery() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez ExecuteNonQuery() będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. Nie należy wywoływać innych metod i właściwości obiektu DbCommand, dopóki zwrócone zadanie nie zostanie ukończone.
ExecuteReader(CommandBehavior)	Wykonuje partię względem połączenia, zwracając DbDataReader, która może służyć do uzyskiwania dostępu do wyników.
ExecuteReaderAsync(CancellationToken)	Asynchroniczna wersja ExecuteReader, która wykonuje partię względem połączenia, zwracając DbDataReader, która może służyć do uzyskiwania dostępu do wyników.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Asynchroniczna wersja ExecuteReader, która wykonuje partię względem połączenia, zwracając DbDataReader, która może służyć do uzyskiwania dostępu do wyników.
ExecuteScalar()	Wykonuje partię i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.
ExecuteScalarAsync(CancellationToken)	Asynchroniczna wersja ExecuteScalar(), która wykonuje partię i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Prepare()	Tworzy przygotowaną (lub skompilowana) wersję partii lub każdego z jego poleceń w źródle danych.
PrepareAsync(CancellationToken)	Asynchronicznie tworzy przygotowaną (lub skompilowana) wersję partii lub każdego z jego poleceń w źródle danych.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, w jaki sposób będą wykonywane oczekiwania na zadania zwrócone z asynchronicznego jednorazowego użytku.