この記事では、この API のリファレンス ドキュメントに補足的な解説を提供します。
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) を参照してください。
注
SequentialAccess
を使用して、大きな値とバイナリ データを取得します。 そうしないと、 OutOfMemoryException が発生し、接続が閉じられます。
SequentialAccess
を指定する場合は、返される順序で列から読み取る必要がありますが、各列を読み取る必要はありません。 返されたデータ ストリーム内の場所を過ぎて読み取ると、その場所以前のデータを DataReader
から読み取れなくなります。 OleDbDataReaderを使用する際、現在の列の値を繰り返し読み取ることができますが、それを超えるまで読み続けることができます。 SqlDataReaderを使用する場合は、列の値を 1 回だけ読み取ることができます。
.NET