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 při zavření přidruženého DataReader objektu.

Default 0

Dotaz může vrátit několik sad výsledků dotazu. 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ů dotazu 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 spouštěným příkazem SET FMTONLY ON.

SequentialAccess 16

Poskytuje způsob pro DataReader zpracování řádků, které obsahují sloupce s velkými binárními hodnotami. Místo načítání celého řádku SequentialAccess nástroj 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ů dotazu.

SingleRow 8

Očekává se, že dotaz vrátí jeden řádek první sady výsledků dotazu. Spuštění dotazu může ovlivnit stav databáze. Někteří zprostředkovatelé dat .NET mohou tyto informace použít k optimalizaci výkonu příkazu, ale nemusí. Pokud zadáte SingleRow pomocí ExecuteReader() metody 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í pouze jeden řádek, může zadání SingleRow také zlepšit výkon aplikace. Při provádění dotazů, u které se očekává vrácení více sad výsledků, je možné zadat SingleRow . V takovém případě, pokud je zadán dotaz SQL 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