DbBatch Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
-
DbBatch
- Implementuje
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 |
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. |
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla