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

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