CommandBehavior 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クエリの結果とそのデータベースへの影響の説明を提供します。
この列挙体は、メンバー値のビットごとの組み合わせをサポートしています。
public enum class CommandBehavior[System.Flags]
public enum CommandBehavior[<System.Flags>]
type CommandBehavior = Public Enum CommandBehavior- 継承
- 属性
フィールド
| 名前 | 値 | 説明 |
|---|---|---|
| Default | 0 | クエリは複数の結果セットを返す場合があります。 クエリの実行がデータベースの状態に影響する可能性があります。
|
| SingleResult | 1 | クエリは 1 つの結果セットを返します。 |
| SchemaOnly | 2 | クエリは列情報のみを返します。 SchemaOnly を使用する場合、SQL Serverの .NET Framework Data Providerは、SET FMTONLY ON で実行されているステートメントの前に置きます。 |
| KeyInfo | 4 | クエリは列と主キーの情報を返します。 プロバイダーは、既存の主キー列とタイムスタンプ列の結果セットに追加の列を追加します。 |
| SingleRow | 8 | クエリは、最初の結果セットの 1 行を返す必要があります。 クエリの実行がデータベースの状態に影響する可能性があります。 データ プロバイダー.NETによっては、この情報を使用してコマンドのパフォーマンスを最適化する場合がありますが、必須ではありません。 |
| SequentialAccess | 16 |
|
| CloseConnection | 32 | コマンドを実行すると、関連付けられた |
注釈
CommandBehavior値は、ExecuteReaderおよび実装クラスのIDbCommand メソッドによって使用されます。
これらの値のビットごとの組み合わせを使用できます。
CommandBehavior は、 SqlNotificationRequest または SqlDependency を定義するときに無視されるため、使用しないでください。 この 2 つの場合は、 CommandBehavior パラメーターを必要としないコンストラクターを使用します。
個々の列挙メンバーに関する注意事項
KeyInfoを使用する場合、.NET Framework Data Provider for SQL Server は、SET FMTONLY OFFとSET NO_BROWSETABLE ONで実行されるステートメントの前に置きます。 ユーザーは、 SET FMTONLY ON ステートメントの使用に対する干渉など、潜在的な副作用を認識する必要があります。 詳細については、 SET FMTONLY (Transact-SQL) を参照してください。
Note
SequentialAccessを使用して、大きな値とバイナリ データを取得します。 そうしないと、 OutOfMemoryException が発生し、接続が閉じられます。
SequentialAccessを指定する場合は、返される順序で列から読み取る必要がありますが、各列を読み取る必要はありません。 返されたデータ ストリーム内の場所を過ぎて読み取ると、その場所以前のデータを DataReaderから読み取れなくなります。
OleDbDataReaderを使用する際、現在の列の値を繰り返し読み取ることができますが、それを超えるまで読み続けることができます。
SqlDataReaderを使用する場合は、列の値を 1 回だけ読み取ることができます。
