IDataRecord インターフェイス

定義

public interface class IDataRecord

public interface IDataRecord

type IDataRecord = interface

Public Interface IDataRecord

派生

System.Data.Common.DbDataReader

System.Data.Common.DbDataRecord

System.Data.EntityClient.EntityDataReader

System.Data.IDataReader

System.Data.IExtendedDataRecord

その他…

例

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

using System;
using System.Data;
using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        ReadOrderData(str);
    }

    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]));
    }
}

Option Explicit On
Option Strict On

Imports System.Data
Imports System.Data.SqlClient

Module Module1

    Sub Main()
        Dim str As String = "Data Source=(local);Initial Catalog=Northwind;" _
       & "Integrated Security=SSPI;"
        ReadOrderData(str)
    End Sub

    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

End Module

注釈

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

アプリケーションは インターフェイスの IDataRecord インスタンスを直接作成するのではなく、 を継承するクラスのインスタンスを作成します IDataRecord。 通常、これを行うには、 オブジェクトの メソッドを DataReader 使用して ExecuteReader を Command 取得します。

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

を実装する DataReader プロバイダーは、共通言語ランタイム (CLR) 型でデータを公開するために必要です。 型強制型変換は、CLR に含まれていない一部の型に対して定義されます。 これらの値は、CLR 型に準拠する代替型としてアクセスできます。 例として、次の表に、OLE DB データ型から CLR 型への推奨されるマッピングと、かっこ内の代替型の一覧を示します。

プロパティ

メソッド

適用対象