DbBatch Třída

Reference

Definice

Obor názvů:: System.Data.Common

Sestavení:: System.Data.Common.dll

Zdroj:: DbBatch.cs

Zdroj:: DbBatch.cs

Zdroj:: DbBatch.cs

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í spouštět ve zdroji dat během jedné doby 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ší v různých ADO.NET poskytovateli, 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

DbBatch()

Inicializuje novou instanci DbBatch třídy.

Vlastnosti

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 objekty.
DbConnection	Při přepsání v odvozené třídě získá nebo nastaví DbConnection používané 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

Cancel()	Pokusí se zrušit spuštění DbBatch.
CreateBatchCommand()	Vytvoří novou instanci objektu DbBatchCommand.
CreateDbBatchCommand()	Při přepsání v odvozené třídě vytvoří novou instanci DbBatchCommand objektu.
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ě dipozici dávkového objektu.
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 vrátí DbDataReader, které lze použít pro přístup k výsledkům.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Zprostředkovatelé by měli tuto metodu implementovat, aby poskytovali ne výchozí implementaci pro ExecuteReader přetížení. 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() budou předány prostřednictvím vrácené vlastnosti Exception úlohy. Nevyvolejte jiné metody a vlastnosti `DbCommand` objektu, dokud vrácená úloha není dokončena.
ExecuteReader(CommandBehavior)	Spustí dávku proti připojení a vrátí DbDataReader, která se dá použít pro přístup k výsledkům.
ExecuteReaderAsync(CancellationToken)	Asynchronní verze ExecuteReader, která provádí dávku proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Asynchronní verze ExecuteReader, která provádí dávku proti jeho připojení, vrací DbDataReader, 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 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í

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Platí pro

Sdílet prostřednictvím