IDataRecord Interfaz

Definición

public interface class IDataRecord

public interface IDataRecord

type IDataRecord = interface

Public Interface IDataRecord

Derivado

System.Data.Common.DbDataReader

System.Data.Common.DbDataRecord

System.Data.EntityClient.EntityDataReader

System.Data.IDataReader

System.Data.IExtendedDataRecord

Más…

Ejemplos

En el ejemplo siguiente se crean instancias de las clases derivadas, SqlConnection, SqlCommandy SqlDataReader. En el ejemplo se leen los datos y se escribe en la consola. Por último, el ejemplo cierra SqlDataReadery, a continuación, .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

Comentarios

Las IDataReader interfaces y IDataRecord permiten que una clase heredada implemente una DataReader clase . Esto proporciona una manera de leer uno o varios flujos de solo avance de conjuntos de resultados. Para obtener más información sobre DataReader las clases, vea Recuperación de datos mediante dataReader.

Una aplicación no crea una instancia de la IDataRecord interfaz directamente, sino que crea una instancia de una clase que hereda IDataRecord. Normalmente, para ello, se obtiene a DataReader través del ExecuteReader método del Command objeto .

Las clases que heredan IDataRecord deben implementar todos los miembros heredados y, normalmente, definir miembros adicionales para agregar funcionalidad específica del proveedor.

Los proveedores que implementan son DataReader necesarios para exponer datos en tipos de Common Language Runtime (CLR). La coerción de tipos se define para algunos tipos que no se incluyen en CLR. Se puede acceder a estos valores como tipos alternativos que cumplan con los tipos CLR. Por ejemplo, en la tabla siguiente se enumeran las asignaciones sugeridas de tipos de datos OLE DB a tipos CLR, con tipos alternativos entre paréntesis.

Propiedades

Métodos

Se aplica a