IDataReader Interface

Definição

public interface class IDataReader : IDisposable, System::Data::IDataRecord

public interface IDataReader : IDisposable, System.Data.IDataRecord

type IDataReader = interface
    interface IDataRecord
    interface IDisposable

type IDataReader = interface
    interface IDisposable
    interface IDataRecord

Public Interface IDataReader
Implements IDataRecord, IDisposable

Derivado

System.Data.Common.DbDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.OracleClient.OracleDataReader

System.Data.SqlClient.SqlDataReader

Implementações

IDataRecord IDisposable

Exemplos

O exemplo a seguir cria instâncias das classes derivadas, SqlConnection, SqlCommande SqlDataReader. O exemplo lê os dados, gravando-os no console. Por fim, o exemplo fecha o SqlDataReadere 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 permitem que uma classe herdada implemente uma DataReader classe , que fornece um meio de ler um ou mais fluxos somente de encaminhamento 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 IDataReader interface diretamente, mas cria uma instância de uma classe que herda IDataReader.

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

As alterações feitas em um conjunto de resultados por outro processo ou thread enquanto os dados estão sendo lidos podem estar visíveis para o usuário de uma classe que implementa um IDataReader. No entanto, o comportamento preciso depende do provedor e do tempo.

Notas aos Implementadores

Para promover a consistência entre .NET Framework provedores de dados, nomeie a classe herdada no formato Prv Command, em que Prv é o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados .NET Framework. Por exemplo, Sql é o prefixo da SqlDataAdapter classe no System.Data.SqlClient namespace .

Os usuários não criam uma instância de uma DataReader classe diretamente. Em vez disso, eles obtêm a DataReader instância por meio do ExecuteReader método do Command objeto . Portanto, você deve marcar DataReader construtores como internos.

Propriedades

Métodos

Aplica-se a