CommandBehavior Výčet

Definice

Obsahuje popis výsledků dotazu a jeho vlivu na databázi.

Tento výčet podporuje bitové kombinace hodnot jeho členů.

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Dědičnost
CommandBehavior
Atributy

Pole

CloseConnection 32

Při spuštění příkazu se přidružený Connection objekt zavře, když je přidružený DataReader objekt zavřený.

Default 0

Dotaz může vrátit několik sad výsledků. Spuštění dotazu může ovlivnit stav databáze. Default nenastavuje žádné CommandBehavior příznaky, takže volání ExecuteReader(CommandBehavior.Default) je funkčně ekvivalentní volání ExecuteReader().

KeyInfo 4

Dotaz vrátí informace o sloupci a primárním klíči. Zprostředkovatel připojí další sloupce k sadě výsledků pro existující sloupce primárního klíče a časového razítka.

SchemaOnly 2

Dotaz vrátí pouze informace o sloupci. Při použití příkazu SchemaOnlypředchází zprostředkovatel dat rozhraní .NET Framework pro SQL Server příkazu, který se spouští pomocí příkazu SET FMTONLY ON.

SequentialAccess 16

Poskytuje způsob zpracování DataReader řádků, které obsahují sloupce s velkými binárními hodnotami. Místo načtení celého řádku SequentialAccess umožňuje DataReader načíst data jako datový proud. Pak můžete použít metodu GetBytes nebo GetChars k určení umístění bajtů pro spuštění operace čtení a omezené velikosti vyrovnávací paměti pro vrácená data.

SingleResult 1

Dotaz vrátí jednu sadu výsledků.

SingleRow 8

Očekává se, že dotaz vrátí jeden řádek první sady výsledků. Spuštění dotazu může ovlivnit stav databáze. Někteří zprostředkovatelé dat .NET mohou, ale nemusí, tyto informace použít k optimalizaci výkonu příkazu. Pokud zadáte SingleRow metodou ExecuteReader() objektu OleDbCommand , zprostředkovatel dat rozhraní .NET Framework pro OLE DB provede vazbu pomocí rozhraní OLE DB IRow , pokud je k dispozici. V opačném případě použije IRowset rozhraní. Pokud se očekává, že příkaz SQL vrátí jenom jeden řádek, může zadání SingleRow také zvýšit výkon aplikace. Je možné zadat SingleRow při provádění dotazů, u které se očekává vrácení více sad výsledků. V takovém případě, kdy je zadán dotaz SQL sady s více výsledky i jeden řádek, bude vrácený výsledek obsahovat pouze první řádek první sady výsledků. Ostatní sady výsledků dotazu se nevrátí.

Poznámky

Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky k rozhraní API pro CommandBehavior.

Platí pro