IDataRecord Arabirim

Tanım

public interface class IDataRecord

public interface IDataRecord

type IDataRecord = interface

Public Interface IDataRecord

Türetilmiş

System.Data.Common.DbDataReader

System.Data.Common.DbDataRecord

System.Data.EntityClient.EntityDataReader

System.Data.IDataReader

System.Data.IExtendedDataRecord

Diğer…

Örnekler

Aşağıdaki örnek, SqlConnection, SqlCommandve SqlDataReadertüretilmiş sınıfların örneklerini oluşturur. Örnek, verileri okuyup konsola yazar. Son olarak, örnek öğesini ve ardından öğesini SqlConnectionkapatırSqlDataReader.

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

Açıklamalar

IDataReader ve IDataRecord arabirimleri, devralan bir sınıfın bir DataReader sınıf uygulamasına olanak tanır. Bu, sonuç kümelerinin yalnızca ileriye doğru bir veya daha fazla akışını okumanın bir yolunu sağlar. Sınıflar hakkında DataReader daha fazla bilgi için bkz. DataReader Kullanarak Veri Alma.

Uygulama doğrudan arabiriminin IDataRecord bir örneğini oluşturmaz, ancak devralan IDataRecordbir sınıfın örneğini oluşturur. Genellikle, nesnesinin ExecuteReader yöntemi Command aracılığıyla bir DataReader alarak bunu yaparsınız.

Devralan IDataRecord sınıfların devralınan tüm üyeleri uygulaması ve genellikle sağlayıcıya özgü işlevsellik eklemek için ek üyeler tanımlaması gerekir.

bir DataReader uygulayan sağlayıcıların ortak dil çalışma zamanı (CLR) türlerindeki verileri kullanıma sunmaları gerekir. ClR'ye dahil olmayan bazı türler için tür zorlaması tanımlanır. Bu değerlere CLR türleriyle uyumlu alternatif türler olarak erişilebilir. Örneğin, aşağıdaki tabloda OLE DB veri türlerinden CLR türlerine önerilen eşlemeler listelenmiştir ve alternatif türler parantez içindedir.

Özellikler

Yöntemler

Şunlara uygulanır