OleDbDataReader クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

OleDbDataReader クラス

データソースからデータ行の前方向ストリームを読み取る方法を提供します。このクラスは継承できません。

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 OleDbDataReader
    Inherits DbDataReader

Visual Basic (使用法)

Dim instance As OleDbDataReader

public sealed class OleDbDataReader : DbDataReader

C++

public ref class OleDbDataReader sealed : public
 DbDataReader

public final class OleDbDataReader extends
 DbDataReader

JScript

public final class OleDbDataReader extends
 DbDataReader

解説

OleDbDataReader を作成するには、コンストラクタを直接使用せずに、OleDbCommand オブジェクトの ExecuteReader メソッドを呼び出す必要があります。

OleDbDataReader の使用中は、関連付けられた OleDbConnection は、その OleDbDataReader によって使用されるためビジー状態になります。この間、OleDbConnection に対して、閉じる以外の操作は実行できません。OleDbDataReader の Close メソッドを呼び出すまでこの状態が続きます。たとえば、Close を呼び出すまでは、出力パラメータは取得できません。

データの読み取り中に別のプロセスまたはスレッドが結果セットに加えた変更が、OleDbDataReader のユーザーに表示されることがあります。ただし、実際に表示されるかどうかは、タイミングによって決まります。

OleDbDataReader を閉じた後に呼び出すことができるのは、IsClosed プロパティと RecordsAffected プロパティだけです。RecordsAffected プロパティは、OleDbDataReader が存在している間はいつでも呼び出すことできますが、正しい戻り値を得るために、RecordsAffected の値を取得する前には、必ず Close を呼び出してください。

使用例

OleDbConnection、OleDbCommand、および OleDbDataReader を作成する例を次に示します。この例では、データを読み取り、コンソールに出力します。最後に、この例では OleDbDataReader を閉じてから、OleDbConnection を閉じます。

Visual Basic

Public Sub ReadData(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

public static void ReadData(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();
    }
}

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
        //string x = "Provider=SQLOLEDB;Data Source=(local);Integrated
 Security=SSPI;Initial Catalog=Northwind";
        //ReadData(x);
    }

    public static void ReadData(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();
        }
    }