CommandBehavior Výčet

Definice

Poskytuje popis výsledků dotazu a jeho vliv 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

Name Hodnota Description
Default 0

Dotaz může vrátit více 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().

SingleResult 1

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

SchemaOnly 2

Dotaz vrátí pouze informace o sloupci. Při použití SchemaOnly Zprostředkovatel dat rozhraní .NET Framework pro SQL Server předchází příkazu SET FMTONLY ON.

KeyInfo 4

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

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ří .NET poskytovatelé dat mohou, ale nevyžadují se, tyto informace používají k optimalizaci výkonu příkazu. Pokud zadáte SingleRow pomocí metody ExecuteReader() objektu OleDbCommand, rozhraní .NET Zprostředkovatel dat Framework pro OLE DB provede vazbu pomocí rozhraní OLE DB IRow, pokud je k dispozici. V opačném případě používá IRowset rozhraní. Pokud se očekává, že příkaz SQL vrátí jenom jeden řádek, může zadává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ě, kdy je zadaný 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 nebudou vráceny.

SequentialAccess 16

Poskytuje způsob, jak DataReader zpracovávat řádky obsahující sloupce s velkými binárními hodnotami. Místo načtení celého řádku SequentialAccess umožňuje DataReader načtení dat jako datového proudu. Potom můžete použít metodu GetBytes nebo GetChars určit umístění bajtů pro spuštění operace čtení a omezenou velikost vyrovnávací paměti pro vrácená data.

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.

Poznámky

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

Platí pro