GetReader(IDbCommand,CommandBehavior) メソッド

指定した動作を使用して、データベース選択用の IDataReader を取得します。

シンタックス

Visual Basic

'宣言
 
Protected Overloads Function GetReader( _
   ByVal currentCommand As IDbCommand, _
   ByVal behavior As CommandBehavior _
) As IDataReader

C#

protected IDataReader GetReader( 
   IDbCommand currentCommand,
   CommandBehavior behavior
)

パラメータ

currentCommand

SELECT文に基づくテキストコマンドまたは複数のレコードを返すストアドプロシージャーを指定する IDbCommand 。

behavior

このメソッドから返された IDataReader がすべてのデータを読み取り終えたときの CommandBehavior 。

戻り値の型

コマンドの結果セットを順方向に読み取る IDataReader 。currentCommand を実行しようとしたときにエラーが発生した場合はnull（またはNothing）を返します。

解説

継承クラスではこのメソッドを使用して、フェッチ操作メソッドの独自の実装の中で初期化した IDbCommand で使用する IDataReader を取得できます。呼び出し時には、 IDataReader がすべてのデータを読み取り終えたときに実行するコマンド動作を指定できます。

Connection が閉じているとデータリーダーの Read を呼び出せないため、このメソッドを呼び出す前に接続が開いていなかった場合は、このメソッドの呼び出し時に接続が開かれます (CloseConnectionなどの behaviors は、このデータリーダーからデータを読み終えたときに接続を効果的に閉じます)。

継承クラスでは、 Connection を初期化して良好な接続が確立される前にこのメソッドを呼び出さないでください。この問題は、必ずデータバインディング操作中に GetReader を呼び出すようにすることで回避できます。