DB2Command.ExecuteReader (CommandBehavior) メソッド

CommandTextConnectionに送信し、いずれかの CommandBehavior 値を使用して DB2DataReader を作成します。

ネーム・スペース:
IBM.Data.DB2
アセンブリー:
IBM.Data.DB2 ( IBM.Data.DB2.dll内)

構文

behaviorbehaviorbehaviorbehavior
[Visual Basic]
Public Function ExecuteReader( _
   ByVal  As CommandBehavior _
) As DB2DataReader

[C#]
public DB2DataReader
 ExecuteReader(
   CommandBehavior 
);
[C++]
public: DB2DataReader
* ExecuteReader(
   CommandBehavior 
);
[JScript]
public function ExecuteReader(
    : CommandBehavior
) : DB2DataReader
;

パラメーター

behavior
いずれか 1 つの System.Data.CommandBehavior 値。

戻り値

DB2®DataReader インスタンス。

注釈

SQL ステートメントから単一の行だけが戻されるはずの場合、SingleRowCommandBehavior 値で指定すると、アプリケーションのパフォーマンスが向上することがあります。

DB2DataReader は、大きなバイナリー値を効率的に読み取ることができる特殊モードをサポートしています。 詳しくは、CommandBehavior の SequentialAccess 設定を参照してください。

同じ DB2Connection インスタンスを使用する複数の DB2DataReader インスタンスからデータに並行してアクセスできます。 各 DB2DataReader インスタンスは、それ自体の DB2Command インスタンスと関連付ける必要があります。

[Visual Basic、C#] 以下の例では、 DB2コマンド を作成し、SQL SELECT ステートメントであるストリングと、データベースへの接続に使用するストリングを渡すことによって実行します。 その後、CommandBehaviorCloseConnection に設定されます。

[Visual Basic]
Public Sub CreateMyDB2DataReader(mySelectQuery As String, _
myConnectionString As String)
    Dim myConnection As New DB2Connection(myConnectionString)
    Dim myCommand As New DB2Command(mySelectQuery, myConnection)
    myCommand.Connection.Open()
    Dim myReader As DB2DataReader = 
        myCommand.ExecuteReader(CommandBehavior.CloseConnection)
    While myReader.Read()
        Console.WriteLine(myReader.GetString(0))
    End While
    myReader.Close()
    myConnection.Close()
 End Sub

[C#]
public void CreateMyDB2DataReader(string mySelectQuery,string myConnectionString)
{
   DB2Connection myConnection = new DB2Connection(myConnectionString);
   DB2Command myCommand = new DB2Command(mySelectQuery, myConnection);
   myCommand.Connection.Open();
   DB2DataReader myReader = 
   myCommand.ExecuteReader(CommandBehavior.CloseConnection);
   while(myReader.Read())
   {
      Console.WriteLine(myReader.GetString(0));
   }
   myReader.Close();
   myConnection.Close();
}