IDataRecord Rozhraní

Definice

public interface class IDataRecord

public interface IDataRecord

type IDataRecord = interface

Public Interface IDataRecord

Odvozené

System.Data.Common.DbDataReader

System.Data.Common.DbDataRecord

System.Data.EntityClient.EntityDataReader

System.Data.IDataReader

System.Data.IExtendedDataRecord

Více…

Příklady

Následující příklad vytvoří instance odvozených tříd , SqlConnectionSqlCommanda SqlDataReader. Příklad přečte data a zapíše je do konzoly. Nakonec příklad zavře SqlDataReadera pak 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

Poznámky

Rozhraní IDataReader a IDataRecord umožňují dědící třídě implementovat DataReader třídu. To poskytuje způsob čtení jednoho nebo více datových proudů pouze dopředných sad výsledků. Další informace o DataReader třídách najdete v tématu Načítání dat pomocí třídy DataReader.

Aplikace nevytvoří instanci IDataRecord rozhraní přímo, ale vytvoří instanci třídy, která dědí IDataRecord. Obvykle to provedete získáním DataReader metody prostřednictvím ExecuteReader objektu Command .

Třídy, které dědí IDataRecord , musí implementovat všechny zděděné členy a obvykle definovat další členy pro přidání funkcí specifických pro zprostředkovatele.

Poskytovatelé implementují DataReader modul , jsou vyžadováni ke zveřejnění dat v typech modulu CLR (Common Language Runtime). Převod typu je definován pro některé typy, které nejsou zahrnuty v CLR. K těmto hodnotám je možné přistupovat jako k alternativním typům, které odpovídají typům CLR. Jako příklad uvádí následující tabulka navrhovaná mapování z datových typů OLE DB na typy CLR s alternativními typy v závorkách.

Vlastnosti

Metody

Platí pro