IDataRecord Interface

Definição

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

Mais…

Exemplos

O exemplo a seguir cria instâncias das classes derivadas, SqlConnectionSqlCommande SqlDataReader. O exemplo lê os dados, gravando-os no console. Por fim, o exemplo fecha o SqlDataReader. e, em seguida, o 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

Comentários

As IDataReader interfaces e IDataRecord as interfaces permitem que uma classe herdada implemente uma DataReader classe. Isso fornece uma maneira de ler um ou mais fluxos somente de avanço de conjuntos de resultados. Para obter mais informações sobre DataReader classes, consulte Recuperando dados usando um DataReader.

Um aplicativo não cria uma instância da IDataRecord interface diretamente, mas cria uma instância de uma classe que herda IDataRecord. Normalmente, você faz isso obtendo um DataReader por meio do ExecuteReader método do Command objeto.

As classes herdadas IDataRecord devem implementar todos os membros herdados e, normalmente, definir membros adicionais para adicionar funcionalidade específica do provedor.

Os provedores que implementam um DataReader são necessários para expor dados em tipos CLR (Common Language Runtime). A coerção de tipo é definida para alguns tipos não incluídos no CLR. Esses valores podem ser acessados como tipos alternativos que estão em conformidade com tipos CLR. Por exemplo, a tabela a seguir lista mapeamentos sugeridos de tipos de dados OLE DB para tipos CLR, com tipos alternativos entre parênteses.