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

範例

以下範例建立了 SqlConnection導出類別 、 、 SqlCommand和 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類別，提供讀取一個或多個僅向前向的結果集串流。 欲了解更多類別 DataReader 資訊，請參閱 使用 DataReader 檢索資料。

應用程式不會直接建立介面的實例 IDataReader ，而是建立一個繼承 的 IDataReader類別實例。

繼承 IDataReader 類別必須實作繼承的成員，並通常定義額外成員以增加提供者專屬功能。

在資料讀取過程中，其他程序或執行緒對結果集所做的變更，可能對實 IDataReader作 的類別使用者可見。 然而，具體行為取決於提供者和時間。

給實施者的注意事項

為了促進.NET Framework 資料提供者間的一致性，將繼承類別命名為 Prv 指令，其中 Prv 是特定 .NET Framework 資料提供者命名空間中所有類別的統一前綴。 例如，Sql是命名空間中SqlDataAdapter類別的前綴System.Data.SqlClient。

使用者不會直接建立類別的 DataReader 實例。 相反地，他們是透過DataReader物件的方法ExecuteReader取得實Command例。 因此，你應該將建構器標記 DataReader 為內部。