CommandBehavior CommandBehavior CommandBehavior CommandBehavior Enum

定義

クエリの結果とそれがデータベースに与える影響を記述します。Provides a description of the results of the query and its effect on the database.

この列挙型には FlagsAttribute 属性があり、メンバー値ではビットごとの組み合わせを使用できます。

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

フィールド

CloseConnection CloseConnection CloseConnection CloseConnection 32

コマンドが実行された場合、関連付けられている DataReader オブジェクトが閉じられたときに、関連付けられている Connection オブジェクトが閉じられます。When the command is executed, the associated Connection object is closed when the associated DataReader object is closed.

Default Default Default Default 0

クエリで複数の結果セットが返される場合があります。The query may return multiple result sets. クエリを実行すると、データベースの状態に影響を与えることがあります。Execution of the query may affect the database state. DefaultCommandBehavior フラグを設定しないので、ExecuteReader(CommandBehavior.Default) の呼び出しは、機能的には ExecuteReader() の呼び出しと同じです。Default sets no CommandBehavior flags, so calling ExecuteReader(CommandBehavior.Default) is functionally equivalent to calling ExecuteReader().

KeyInfo KeyInfo KeyInfo KeyInfo 4

クエリでは列と主キーの情報が返されます。The query returns column and primary key information.

SchemaOnly SchemaOnly SchemaOnly SchemaOnly 2

クエリでは列情報のみが返されます。The query returns column information only. SchemaOnly を使用している場合、SQL Server 用 .NET Framework データ プロバイダーは実行するステートメントの前に SET FMTONLY ON を指定します。When using SchemaOnly, the .NET Framework Data Provider for SQL Server precedes the statement being executed with SET FMTONLY ON.

SequentialAccess SequentialAccess SequentialAccess SequentialAccess 16

DataReader が大きなバイナリ値が格納されている列を含む行を処理できるようにします。Provides a way for the DataReader to handle rows that contain columns with large binary values. SequentialAccess を使用すると、DataReader は行全体を読み込むのではなく、ストリームとしてデータを読み込むことができます。Rather than loading the entire row, SequentialAccess enables the DataReader to load data as a stream. その後、GetBytes メソッドまたは GetChars メソッドを使用して、読み込み動作を開始するバイト位置、返すデータの制限付きバッファー サイズを指定できます。You can then use the GetBytes or GetChars method to specify a byte location to start the read operation, and a limited buffer size for the data being returned.

SingleResult SingleResult SingleResult SingleResult 1

クエリでは単一の結果セットが返されます。The query returns a single result set.

SingleRow SingleRow SingleRow SingleRow 8

クエリは、最初の結果セットの単一行を返すと想定されます。The query is expected to return a single row of the first result set. クエリを実行すると、データベースの状態に影響を与えることがあります。Execution of the query may affect the database state. 一部の .NET Framework データ プロバイダーではこの情報を使用してコマンドのパフォーマンスを最適化することもできますが、この情報の使用は必須ではありません。Some .NET Framework data providers may, but are not required to, use this information to optimize the performance of the command. OleDbCommand オブジェクトの ExecuteReader() メソッドで SingleRow を指定すると、OLE DB IRow インターフェイスが使用できる場合、OLE DB 用 .NET Framework データ プロバイダーはこのインターフェイスを使用してバインドを実行します。When you specify SingleRow with the ExecuteReader() method of the OleDbCommand object, the .NET Framework Data Provider for OLE DB performs binding using the OLE DB IRow interface if it is available. それ以外の場合は、IRowset インターフェイスを使用します。Otherwise, it uses the IRowset interface. SQL ステートメントが単一行のみを返すことが予期される場合、SingleRow を指定すると、アプリケーションのパフォーマンスも向上します。If your SQL statement is expected to return only a single row, specifying SingleRow can also improve application performance. 複数の結果セットを返すことが予期されるクエリを実行する場合は、SingleRow を指定できます。It is possible to specify SingleRow when executing queries that are expected to return multiple result sets. その場合、複数の結果セットの SQL クエリと単一行の両方が指定されていると、返される結果には最初の結果セットの 1 行目のみが含まれます。In that case, where both a multi-result set SQL query and single row are specified, the result returned will contain only the first row of the first result set. クエリの他の結果セットは返されません。The other result sets of the query will not be returned.

注釈

CommandBehavior値によって使用されます、ExecuteReaderメソッドのIDbCommandそこから派生した任意のクラスとします。The CommandBehavior values are used by the ExecuteReader method of IDbCommand and any classes derived from it.

これらの値のビットごとの組み合わせを使用できます。A bitwise combination of these values may be used.

CommandBehavior 定義するために使用する場合は無視されます、SqlNotificationRequestまたはSqlDependencyとはそのため、使用できません。CommandBehavior is ignored when used to define a SqlNotificationRequest or SqlDependency and should therefore not be used. 必要としないコンス トラクターを使用して、CommandBehaviorこれら 2 つのケースでのパラメーター。Use the constructor that does not require a CommandBehavior parameter in these two cases.

注意

SequentialAccess を使用すると、大きな値およびバイナリ データを取得できます。Use SequentialAccess to retrieve large values and binary data. それ以外の場合、OutOfMemoryExceptionが発生して、接続は閉じられます。Otherwise, an OutOfMemoryException might occur and the connection will be closed.

適用対象