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é lze spouštět na zdroji dat v rámci jedné odezvy. Poskytuje základní třídu pro třídy specifické pro databáze, 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 dávkového spouštění se liší u poskytovatelů ADO.NET, 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 dávce, přeskočit všechny následné příkazy a vrátit zpět spuštěné příkazy. Toto chování však nemusí být podporováno napříč databázemi; projděte si dokumentaci poskytovatele ADO.NET.

Konstruktory

Name	Description
DbBatch()	Inicializuje novou instanci DbBatch třídy.

Vlastnosti

Name	Description
BatchCommands	Získá kolekci DbBatchCommand objektů.
Connection	Získá nebo nastaví DbConnection používané 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í DbConnection použité tímto DbBatch.
DbTransaction	Při přepsání v odvozené třídě získá nebo nastaví, DbTransaction ve kterém se tento DbBatch objekt spustí.
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 se tento DbBatch objekt spustí.

Metody

Name	Description
Cancel()	Pokusí se zrušit spuštění příkazu DbBatch.
CreateBatchCommand()	Vytvoří novou instanci objektu DbBatchCommand .
CreateDbBatchCommand()	Při přepsání v odvozené třídě vytvoří novou instanci objektu DbBatchCommand .
Dispose()	Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků.
DisposeAsync()	Asynchronně odstraní dávkový objekt.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
ExecuteDbDataReader(CommandBehavior)	Při přepsání v odvozené třídě spustí dávku proti jeho připojení a DbDataReader vrátí hodnotu, kterou lze použít pro přístup k výsledkům.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Poskytovatelé by měli tuto metodu implementovat, aby poskytovali ne výchozí implementaci přetížení 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šený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteReader budou oznámeny prostřednictvím vrácené Task Exception vlastnost. Tato metoda přijímá token zrušení, který lze použít k vyžádání operace, aby byla zrušena dříve. Implementace můžou tento požadavek ignorovat.
ExecuteNonQuery()	Provede dávku proti objektu připojení a vrátí celkový počet řádků ovlivněných všemi příkazy dávky.
ExecuteNonQueryAsync(CancellationToken)	Toto je asynchronní verze 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šený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteNonQuery() výjimkou budou oznámeny prostřednictvím vrácené vlastnosti Exception úkolu. Nevyvolejte jiné metody a vlastnosti objektu DbCommand , dokud nebude vrácena úloha dokončena.
ExecuteReader(CommandBehavior)	Provede dávku proti jeho připojení a vrátí DbDataReader ji, která se dá použít pro přístup k výsledkům.
ExecuteReaderAsync(CancellationToken)	Asynchronní verze ExecuteReader, která spouští dávku proti jeho připojení, vrací DbDataReader , která se dá použít pro přístup k výsledkům.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Asynchronní verze ExecuteReader, která spouští dávku proti jeho připojení, vrací DbDataReader , která se dá 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 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í funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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í

Name	Description
ConfigureAwait(IAsyncDisposable, Boolean)	Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.