IDataRecord Interfaccia

Definizione

public interface class IDataRecord

public interface IDataRecord

type IDataRecord = interface

Public Interface IDataRecord

Derivato

System.Data.Common.DbDataReader

System.Data.Common.DbDataRecord

System.Data.EntityClient.EntityDataReader

System.Data.IDataReader

System.Data.IExtendedDataRecord

Altro…

Esempio

Nell'esempio seguente vengono create istanze delle classi derivate, SqlConnectionSqlCommande SqlDataReader. L'esempio legge i dati, scrivendolo nella console. Infine, l'esempio chiude l'oggetto SqlDataReadere quindi .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

Commenti

Le IDataReader interfacce e IDataRecord consentono a una classe di eredita di implementare una DataReader classe. In questo modo è possibile leggere uno o più flussi di risultati di tipo forward-only. Per altre informazioni sulle classi, vedere Recupero di DataReaderdati tramite un dataReader.

Un'applicazione non crea direttamente un'istanza dell'interfaccia, ma crea un'istanza IDataRecord di una classe che eredita IDataRecord. In genere, si ottiene un DataReader tramite il ExecuteReader metodo dell'oggetto Command .

Le classi che ereditano devono implementare IDataRecord tutti i membri ereditati e in genere definiscono altri membri per aggiungere funzionalità specifiche del provider.

I provider che implementano un DataReader oggetto sono necessari per esporre i dati nei tipi CLR (Common Language Runtime). La coercizione dei tipi è definita per alcuni tipi non inclusi in CLR. Questi valori possono essere accessibili come tipi alternativi conformi ai tipi CLR. Ad esempio, la tabella seguente elenca i mapping suggeriti dai tipi di dati OLE DB ai tipi CLR, con tipi alternativi nelle parentesi.

Proprietà

Metodi

Si applica a