IDataReader インターフェイス

定義

public interface class IDataReader : IDisposable, System::Data::IDataRecord

public interface IDataReader : IDisposable, System.Data.IDataRecord

type IDataReader = interface
    interface IDataRecord
    interface IDisposable

type IDataReader = interface
    interface IDisposable
    interface IDataRecord

Public Interface IDataReader
Implements IDataRecord, IDisposable

派生

System.Data.Common.DbDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.OracleClient.OracleDataReader

System.Data.SqlClient.SqlDataReader

実装

IDataRecord IDisposable

例

次の例では、派生クラス、、、SqlConnectionSqlCommandおよび のインスタンスを作成しますSqlDataReader。 この例では、データを読み取り、コンソールに書き込みます。 最後に、この例では を閉じ、 SqlDataReader次に を SqlConnection閉じます。

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";

    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        SqlCommand command =
            new SqlCommand(queryString, connection);
        connection.Open();

        SqlDataReader reader = command.ExecuteReader();

        // Call Read before accessing data.
        while (reader.Read())
        {
            ReadSingleRow((IDataRecord)reader);
        }

        // Call Close when done reading.
        reader.Close();
    }
}

private static void ReadSingleRow(IDataRecord dataRecord)
{
    Console.WriteLine(String.Format("{0}, {1}", dataRecord[0], dataRecord[1]));
}

Private Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call Read before accessing data.
        While reader.Read()
            ReadSingleRow(CType(reader, IDataRecord))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Private Sub ReadSingleRow(ByVal record As IDataRecord)
   Console.WriteLine(String.Format("{0}, {1}", record(0), record(1)))
End Sub

注釈

IDataReaderインターフェイスと IDataRecord インターフェイスを使用すると、継承クラスで クラスをDataReader実装できます。これにより、結果セットの 1 つ以上の前方専用ストリームを読み取る手段が提供されます。 クラスの詳細 DataReader については、「 DataReader を使用したデータの取得」を参照してください。

アプリケーションは インターフェイスの IDataReader インスタンスを直接作成するのではなく、 を継承するクラスのインスタンスを作成します IDataReader。

IDataReader を継承するクラスは、継承されたメンバーを実装し、通常は、プロバイダー固有の機能を追加するための追加メンバーを定義する必要があります。

データが読み取られている間に別のプロセスまたはスレッドによって結果セットに加えられた変更は、IDataReader を実装するクラスのユーザーに表示される場合がありますが、 正確な動作は、プロバイダーとタイミングに応じて変わります。

注意 (実装者)

.NET Framework データ プロバイダー間の一貫性を高めるために、継承クラスに Command という形式Prvで名前を付けます。ここでPrv、 は、特定の.NET Framework データ プロバイダー名前空間内のすべてのクラスに渡される均一なプレフィックスです。 たとえば、 Sql は 名前空間の System.Data.SqlClient クラスのSqlDataAdapterプレフィックスです。

ユーザーは、クラスのインスタンスを DataReader 直接作成しません。 代わりに、 オブジェクトの メソッドをDataReaderExecuteReader使用してインスタンスをCommand取得します。 したがって、コンストラクターを内部としてマーク DataReader する必要があります。

プロパティ

メソッド

適用対象