OleDbCommand.ExecuteReader メソッド

定義

名前空間:

System.Data.OleDb

アセンブリ:

System.Data.OleDb.dll

パッケージ:

System.Data.OleDb v8.0.0

CommandText を Connection に送信し、OleDbDataReader を構築します。

オーバーロード

ExecuteReader()	CommandText を Connection に送信し、OleDbDataReader を構築します。
ExecuteReader(CommandBehavior)	CommandText を Connection に送信し、CommandBehavior 値のいずれかを使用して OleDbDataReader を構築します。

ExecuteReader()

CommandText を Connection に送信し、OleDbDataReader を構築します。

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();

public System.Data.OleDb.OleDbDataReader ExecuteReader ();

override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader () As OleDbDataReader

戻り値

OleDbDataReader

OleDbDataReader オブジェクト。

例外

InvalidOperationException

接続を登録した当初のトランザクション コンテキストとは異なるコンテキストでは、コマンドを実行できません。

例

次の例では、 を OleDbCommand作成し、SQL SELECT ステートメントである文字列と、データ ソースへの接続に使用する文字列を渡して実行します。

public void CreateReader(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}

Public Sub CreateReader(ByVal connectionString As String, _
    ByVal queryString As String)

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

注釈

CommandType プロパティが StoredProcedure に設定されている場合は、CommandText プロパティをストアド プロシージャの名前に設定します。 ExecuteReader を呼び出すときに、コマンドによってこのストアド プロシージャが実行されます。

を閉じる前に、 OleDbConnectionまず オブジェクトを OleDbDataReader 閉じます。 オブジェクトを再利用OleDbCommandするOleDbDataReader場合は、オブジェクトを閉じる必要もあります。

こちらもご覧ください

• コマンドの操作

ExecuteReader(CommandBehavior)

CommandText を Connection に送信し、CommandBehavior 値のいずれかを使用して OleDbDataReader を構築します。

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.OleDb.OleDbDataReader ExecuteReader (System.Data.CommandBehavior behavior);

override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

パラメーター

behavior

CommandBehavior

CommandBehavior 値のいずれか 1 つ。

戻り値

OleDbDataReader

OleDbDataReader オブジェクト。

例外

InvalidOperationException

接続を登録した当初のトランザクション コンテキストとは異なるコンテキストでは、コマンドを実行できません。

例

次の例では、 を OleDbCommand作成し、Transact-SQL SELECT ステートメントである文字列と、データ ソースへの接続に使用する文字列を渡して実行します。 CommandBehavior が CloseConnection に設定されます。

public void CreateMyOleDbDataReader(string queryString,string connectionString)
{
   OleDbConnection connection = new OleDbConnection(connectionString);
   OleDbCommand command = new OleDbCommand(queryString, connection);
   connection.Open();
   OleDbDataReader reader = command.ExecuteReader(CommandBehavior.CloseConnection);
   while(reader.Read())
   {
      Console.WriteLine(reader.GetString(0));
   }
   reader.Close();
   //Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
}

Public Sub CreateMyOleDbDataReader(queryString As String, _
    connectionString As String)
    Dim connection As New OleDbConnection(connectionString)
    Dim command As New OleDbCommand(queryString, connection)
    connection.Open()
    Dim reader As OleDbDataReader = command.ExecuteReader(CommandBehavior.CloseConnection)
    While reader.Read()
        Console.WriteLine(reader.GetString(0))
    End While
    reader.Close()
    'Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
 End Sub

注釈

オブジェクトの OleDbCommand メソッドで をExecuteReader指定SingleRowすると、.NET Framework Data Provider for OLE DB は、使用可能な場合は OLE DB IRow インターフェイスを使用してバインドを実行します。 それ以外の場合は、 IRowset インターフェイスを使用します。 SQL ステートメントが単一行のみを返すことが予期される場合、SingleRow を指定すると、アプリケーションのパフォーマンスも向上します。

CommandType プロパティが StoredProcedure に設定されている場合は、CommandText プロパティをストアド プロシージャの名前に設定します。 ExecuteReader を呼び出すときに、コマンドによってこのストアド プロシージャが実行されます。

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

を閉じる前に、 OleDbConnectionまず オブジェクトを OleDbDataReader 閉じます。 オブジェクトを再利用OleDbCommandするOleDbDataReader場合は、オブジェクトを閉じる必要もあります。 を OleDbDataReader に設定して CloseConnectionが作成された場合、 をOleDbDataReader閉じるとCommandBehavior、接続が自動的に閉じます。

こちらもご覧ください

• コマンドの操作