DbBatch Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje dávku příkazů, které se dají spustit proti zdroji dat v rámci jedné doby odezvy. Poskytuje základní třídu pro třídy specifické pro databázi, které představují dávky příkazů.
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
- Dědičnost
-
DbBatch
- Implementuje
Poznámky
Přesná sémantika spouštění dávek se u různých poskytovatelů ADO.NET liší, zejména v případě zpracování chyb. Pokud je to možné, doporučuje se okamžitě ukončit dávku chybou v příkazu v rámci dávky, přeskočit všechny následující příkazy a vrátit zpět již spuštěné příkazy. Toto chování však nemusí být podporováno napříč databázemi. nahlédněte do dokumentace poskytovatele ADO.NET.
Konstruktory
DbBatch() |
Inicializuje novou instanci DbBatch třídy. |
Vlastnosti
BatchCommands |
Získá kolekci DbBatchCommand objektů. |
Connection |
Získá nebo nastaví DbConnection použitý tímto DbBatch. |
DbBatchCommands |
Při přepsání v odvozené třídě získá kolekci DbBatchCommand objektů. |
DbConnection |
Při přepsání v odvozené třídě získá nebo nastaví hodnotu použitou DbConnection touto DbBatchtřídou . |
DbTransaction |
Při přepsání v odvozené třídě získá nebo nastaví, DbTransaction v rámci kterého se tento DbBatch objekt provádí. |
Timeout |
Získá nebo nastaví dobu čekání (v sekundách) před ukončením pokusu o spuštění dávky a generování chyby. |
Transaction |
Získá nebo nastaví, DbTransaction ve kterém tento DbBatch objekt provede. |
Metody
Cancel() |
Pokusy o zrušení provádění DbBatchpříkazu . |
CreateBatchCommand() |
Vytvoří novou instanci objektu DbBatchCommand . |
CreateDbBatchCommand() |
Při přepsání v odvozené třídě vytvoří novou instanci objektu DbBatchCommand . |
Dispose() |
Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků. |
DisposeAsync() |
Asynchronně rozdělí objekt batch. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
ExecuteDbDataReader(CommandBehavior) |
Při přepsání v odvozené třídě spustí dávku proti svému připojení a vrátí DbDataReader hodnotu, která se dá použít pro přístup k výsledkům. |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
Zprostředkovatelé by měli implementovat tuto metodu, aby poskytovala pro přetížení jinou než výchozí implementaci ExecuteReader . Výchozí implementace vyvolá synchronní ExecuteReader() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteReader budou sděleny prostřednictvím vlastnosti vrácené výjimky úlohy. Tato metoda přijímá token zrušení, který lze použít k žádosti o předčasné zrušení operace. Implementace můžou tento požadavek ignorovat. |
ExecuteNonQuery() |
Spustí dávku proti objektu připojení a vrátí celkový počet ovlivněných řádků ve všech dávkových příkazech. |
ExecuteNonQueryAsync(CancellationToken) |
Toto je asynchronní verze nástroje ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován. Výchozí implementace vyvolá synchronní ExecuteNonQuery() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteNonQuery() budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. Nevyvolávej jiné metody a vlastnosti objektu |
ExecuteReader(CommandBehavior) |
Spustí dávku proti svému připojení a vrátí DbDataReader hodnotu, která se dá použít pro přístup k výsledkům. |
ExecuteReaderAsync(CancellationToken) |
Asynchronní verze nástroje ExecuteReader, která provádí dávku proti svému připojení a vrací DbDataReader objekt, který lze použít pro přístup k výsledkům. |
ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Asynchronní verze nástroje ExecuteReader, která provádí dávku proti svému připojení a vrací DbDataReader objekt, který lze použít pro přístup k výsledkům. |
ExecuteScalar() |
Provede dávku a vrátí první sloupec prvního řádku v první vrácené sadě výsledků. Všechny ostatní sloupce, řádky a sady výsledků se ignorují. |
ExecuteScalarAsync(CancellationToken) |
Asynchronní verze nástroje ExecuteScalar(), která spustí dávku a vrátí první sloupec prvního řádku v první vrácené sadě výsledků. Všechny ostatní sloupce, řádky a sady výsledků se ignorují. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
Prepare() |
Vytvoří připravenou (nebo zkompilovanou) verzi dávky nebo každého z jejích příkazů ve zdroji dat. |
PrepareAsync(CancellationToken) |
Asynchronně vytvoří připravenou (nebo zkompilovanou) verzi dávky nebo každého z jejích příkazů ve zdroji dat. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Metody rozšíření
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguruje, jak se provádí čekání na úlohy vrácené z asynchronního jednorázového použití. |
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro