DbBatch Třída

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Zdroj:

DbBatch.cs

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

Object

DbBatch

Implementuje

IAsyncDisposable IDisposable

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 DbCommand , dokud nebude dokončena vrácená úloha.
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í.