IDataReader Interface

Definição

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

public interface IDataReader : IDisposable, System.Data.IDataRecord

type IDataReader = interface
    interface IDisposable
    interface IDataRecord

type IDataReader = interface
    interface IDataRecord
    interface IDisposable

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 seguinte cria instâncias das classes derivadas, SqlConnection, SqlCommand, e SqlDataReader. O exemplo lê os dados, escrevendo-os para a consola. Finalmente, o exemplo fecha o SqlDataReader, depois 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

Observações

As IDataReader interfaces e IDataRecord permitem que uma classe herdadora implemente uma DataReader classe, o que fornece um meio de ler um ou mais fluxos apenas diretos de conjuntos de resultados. Para mais informações sobre DataReader classes, consulte Recuperar Dados Usando um Leitor de Dados.

Uma aplicação não cria diretamente uma instância da IDataReader interface, mas cria uma instância de uma classe que herda IDataReader.

As classes que herdam IDataReader devem implementar os membros herdados, e normalmente definem membros adicionais para adicionar funcionalidades específicas do fornecedor.

Alterações feitas a um conjunto de resultados por outro processo ou thread enquanto os dados estão a ser lidos podem ser visíveis para o utilizador de uma classe que implementa um IDataReader. No entanto, o comportamento exato depende tanto do provedor como do timing.

Notas para Implementadores

Para promover a consistência entre .NET fornecedores de dados do Framework, nomeie a classe herdeira na forma , onde é o prefixo uniforme dado a todas as classes num espaço de nomes específico do fornecedor de dados .NET Framework. Por exemplo, Sql é o prefixo da SqlDataAdapter classe no System.Data.SqlClient namespace.

Os utilizadores não criam diretamente uma instância de uma DataReader classe. Em vez disso, obtêm a DataReader instância através do ExecuteReader método do Command objeto. Por isso, deve marcar DataReader os construtores como internos.