CommandBehavior 列挙型

定義

クエリの結果とそのデータベースへの影響の説明を提供します。

この列挙体は、メンバー値のビットごとの組み合わせをサポートしています。

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
継承
CommandBehavior
属性

フィールド

名前 説明
Default 0

クエリは複数の結果セットを返す場合があります。 クエリの実行がデータベースの状態に影響する可能性があります。 DefaultCommandBehavior フラグを設定しないため、 ExecuteReader(CommandBehavior.Default) の呼び出しは、 ExecuteReader()の呼び出しと機能的に同等です。

SingleResult 1

クエリは 1 つの結果セットを返します。

SchemaOnly 2

クエリは列情報のみを返します。 SchemaOnly を使用する場合、SQL Serverの .NET Framework Data Providerは、SET FMTONLY ON で実行されているステートメントの前に置きます。

KeyInfo 4

クエリは列と主キーの情報を返します。 プロバイダーは、既存の主キー列とタイムスタンプ列の結果セットに追加の列を追加します。

SingleRow 8

クエリは、最初の結果セットの 1 行を返す必要があります。 クエリの実行がデータベースの状態に影響する可能性があります。 データ プロバイダー.NETによっては、この情報を使用してコマンドのパフォーマンスを最適化する場合がありますが、必須ではありません。 オブジェクトの メソッドで を指定すると .NET、OLE DB < Data Provider c3 /> インターフェイスを使用してバインドが実行されます (使用可能な場合)。 それ以外の場合は、 IRowset インターフェイスを使用します。 SQL ステートメントが 1 行のみを返すと予想される場合は、 SingleRow を指定すると、アプリケーションのパフォーマンスも向上する可能性があります。 複数の結果セットを返すと予想されるクエリを実行するときに、 SingleRow を指定できます。 その場合、複数結果セットの SQL クエリと 1 つの行の両方が指定されている場合、返される結果には最初の結果セットの最初の行のみが含まれます。 クエリの他の結果セットは返されません。

SequentialAccess 16

DataReaderが大きなバイナリ値を持つ列を含む行を処理する方法を提供します。 SequentialAccessは、行全体を読み込むのではなく、DataReaderがストリームとしてデータを読み込むことができます。 その後、 GetBytes メソッドまたは GetChars メソッドを使用して、読み取り操作を開始するバイト位置と、返されるデータのバッファー サイズを制限することができます。

CloseConnection 32

コマンドを実行すると、関連付けられた Connection オブジェクトは、関連付けられた DataReader オブジェクトが閉じられると閉じられます。

注釈

この API の詳細については、「 CommandBehavior の補足 API 解説」を参照してください。

適用対象