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ładne semantyka wykonywania wsadowego różni się w zależności od dostawców ADO.NET, zwłaszcza w przypadku obsługi błędów. Jeśli to możliwe, zaleca się, aby błąd w poleceniu w partii natychmiast zakończyć partię, pominąć wszystkie kolejne polecenia i wycofać polecenia, które już wykonano. Jednak to 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ę DbBatchCommand obiektów.
Connection	Pobiera lub ustawia wartość używaną DbConnection przez ten DbBatchelement .
DbBatchCommands	Po przesłonięciu w klasie pochodnej pobiera kolekcję DbBatchCommand obiektów.
DbConnection	Po przesłonięciu w klasie pochodnej pobiera lub ustawia wartość używaną przez tę DbBatchklasę DbConnection .
DbTransaction	W przypadku zastąpienia w klasie pochodnej pobiera lub ustawia DbTransaction obiekt, w którym jest wykonywany ten DbBatch obiekt.
Timeout	Pobiera lub ustawia czas oczekiwania (w sekundach) przed zakończeniem próby wykonania partii i wygenerowaniu błędu.
Transaction	Pobiera lub ustawia DbTransaction obiekt, w którym jest wykonywany ten DbBatch obiekt.

Metody

Cancel()	Próbuje anulować wykonanie elementu DbBatch.
CreateBatchCommand()	Tworzy nowe wystąpienie DbBatchCommand obiektu.
CreateDbBatchCommand()	Po przesłonięciu w klasie pochodnej tworzy nowe wystąpienie DbBatchCommand obiektu.
Dispose()	Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.
DisposeAsync()	Asynchronicznie dysponuje obiekt wsadowy.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)	Po przesłonięciu w klasie pochodnej wykonuje partię względem połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Dostawcy powinni zaimplementować tę metodę w celu zapewnienia nie domyślnej implementacji ExecuteReader przeciążeń. Domyślna implementacja wywołuje metodę synchroniczną 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ątku 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 programu ExecuteNonQuery(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany. Domyślna implementacja wywołuje metodę synchroniczną 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łoszone przez ExecuteNonQuery() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. Nie należy wywoływać innych metod i właściwości DbCommand obiektu, dopóki zwrócone zadanie nie zostanie ukończone.
ExecuteReader(CommandBehavior)	Wykonuje partię względem połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.
ExecuteReaderAsync(CancellationToken)	Asynchroniczna wersja programu ExecuteReader, która wykonuje partię względem połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Asynchroniczna wersja programu ExecuteReader, która wykonuje partię względem połączenia, zwracając element DbDataReader , który 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 elementu 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()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (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 sposób oczekiwania na zadania zwracane z asynchronicznego jednorazowego wykonania.