Compartilhar via

Classe SqlCeDataReader

  • Artigo

Fornece uma maneira de ler um fluxo apenas de encaminhamento de linhas de dados de uma fonte de dados. Esta classe não pode ser herdada.

Hierarquia de herança

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbDataReader
      System.Data.SqlServerCe.SqlCeDataReader
        System.Data.SqlServerCe.SqlCeResultSet

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Class SqlCeDataReader _
    Inherits DbDataReader
'Uso
Dim instance As SqlCeDataReader

public class SqlCeDataReader : DbDataReader

public ref class SqlCeDataReader : public DbDataReader

type SqlCeDataReader =  
    class
        inherit DbDataReader
    end

public class SqlCeDataReader extends DbDataReader

O tipo SqlCeDataReader expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública Depth Obtém um valor que indica a profundidade do aninhamento da linha atual. (Substitui DbDataReader.Depth.)
Propriedade pública FieldCount Obtém o número de colunas na cláusula SELECT da consulta. (Substitui DbDataReader.FieldCount.)
Propriedade pública HasRows Obtém um valor que indica se SqlCeDataReader contém uma ou mais linhas (Substitui DbDataReader.HasRows.)
Propriedade pública HiddenFieldCount Infraestrutura.
Propriedade pública IsClosed Indica se o leitor de dados está fechado. (Substitui DbDataReader.IsClosed.)
Propriedade pública Item[Int32] Obtém o valor da coluna especificada em seu formato nativo, dado o ordinal da coluna. (Substitui DbDataReader.Item[Int32].)
Propriedade pública Item[String] Obtém o valor da coluna especificada em seu formato nativo, dado o nome da coluna. (Substitui DbDataReader.Item[String].)
Propriedade pública RecordsAffected Obtém o número de linhas alteradas, inseridas ou excluídas pela execução da instrução SQL. (Substitui DbDataReader.RecordsAffected.)
Propriedade pública VisibleFieldCount (herança de DbDataReader)

Início

Métodos

  Nome Descrição
Método público Close Fecha o objeto SqlCeDataReader. (Substitui DbDataReader.Close().)
Método público CreateObjRef (herança de MarshalByRefObject)
Método público Dispose() Infraestrutura. Libera os recursos consumidos por este SqlCeDataReader.
Método protegido Dispose(Boolean) Libera os recursos não gerenciados usados por este SqlCeDataReader e, opcionalmente, libera também os recursos gerenciados. (Substitui DbDataReader.Dispose(Boolean).)
Método público Equals (herança de Object)
Método protegido Finalize Libera recursos não gerenciados e executa outras operações de limpeza antes de SqlCeDataReader ser recuperado pela coleta de lixo. (Substitui Object.Finalize().)
Método público GetBoolean Obtém o valor da coluna especificada como um booliano. (Substitui DbDataReader.GetBoolean(Int32).)
Método público GetByte Obtém o valor da coluna especificada como um byte. (Substitui DbDataReader.GetByte(Int32).)
Método público GetBytes Lê um fluxo de bytes do deslocamento de coluna especificado no buffer como uma matriz que inicia no deslocamento de buffer fornecido. (Substitui DbDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32).)
Método público GetChar Sem suporte no Provedor de Dados do .NET Compact Framework para SQL Server Compact. (Substitui DbDataReader.GetChar(Int32).)
Método público GetChars Lê um fluxo de caracteres do deslocamento de coluna especificado no buffer como uma matriz que inicia no deslocamento de buffer fornecido. (Substitui DbDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32).)
Método público GetData (herança de DbDataReader)
Método público GetDataTypeName Obtém o nome do tipo de dados de origem. (Substitui DbDataReader.GetDataTypeName(Int32).)
Método público GetDateTime Obtém o valor da coluna especificada como um objeto DateTime. (Substitui DbDataReader.GetDateTime(Int32).)
Método protegido GetDbDataReader (herança de DbDataReader)
Método público GetDecimal Obtém o valor da coluna especificada como um objeto Decimal. (Substitui DbDataReader.GetDecimal(Int32).)
Método público GetDouble Obtém o valor da coluna especificada como um número de ponto flutuante de precisão dupla. (Substitui DbDataReader.GetDouble(Int32).)
Método público GetEnumerator Infraestrutura. (Substitui DbDataReader.GetEnumerator().)
Método público GetFieldType Obtém o Type que é o tipo de dados do objeto. (Substitui DbDataReader.GetFieldType(Int32).)
Método público GetFloat Obtém o valor da coluna especificada como um número de ponto flutuante de precisão simples. (Substitui DbDataReader.GetFloat(Int32).)
Método público GetGuid Obtém o valor da coluna especificada como um identificador global exclusivo (GUID). (Substitui DbDataReader.GetGuid(Int32).)
Método público GetHashCode (herança de Object)
Método público GetInt16 Obtém o valor da coluna especificada como um inteiro com sinal de 16 bits. (Substitui DbDataReader.GetInt16(Int32).)
Método público GetInt32 Obtém o valor da coluna especificada como um inteiro assinado de 32 bits. (Substitui DbDataReader.GetInt32(Int32).)
Método público GetInt64 Obtém o valor da coluna especificada como um inteiro assinado de 64 bits. (Substitui DbDataReader.GetInt64(Int32).)
Método público GetLifetimeService (herança de MarshalByRefObject)
Método público GetName Obtém nome da coluna especificada. (Substitui DbDataReader.GetName(Int32).)
Método público GetOrdinal Obtém o ordinal da coluna, desde que seu nome seja fornecido. (Substitui DbDataReader.GetOrdinal(String).)
Método público GetProviderSpecificFieldType Obtém um Object que é uma representação do tipo de campo específico do provedor subjacente. (Substitui DbDataReader.GetProviderSpecificFieldType(Int32).)
Método público GetProviderSpecificValue (herança de DbDataReader)
Método público GetProviderSpecificValues (herança de DbDataReader)
Método público GetSchemaTable Retorna uma DataTable que descreve os metadados da coluna do SqlCeDataReader. (Substitui DbDataReader.GetSchemaTable().)
Método público GetSqlBinary Obtém o valor da coluna especificada como um SqlBinary.
Método público GetSqlBoolean Obtém o valor da coluna especificada como um SqlBoolean.
Método público GetSqlByte Obtém o valor da coluna especificada como um SqlByte.
Método público GetSqlDateTime Obtém o valor da coluna especificada como um SqlDateTime.
Método público GetSqlDecimal Obtém o valor da coluna especificada como um SqlDecimal.
Método público GetSqlDouble Obtém o valor da coluna especificada como um SqlDouble.
Método público GetSqlGuid Obtém o valor da coluna especificada como um SqlGuid.
Método público GetSqlInt16 Obtém o valor da coluna especificada como um SqlInt16.
Método público GetSqlInt32 Obtém o valor da coluna especificada como um SqlInt32.
Método público GetSqlInt64 Obtém o valor da coluna especificada como um SqlInt64.
Método público GetSqlMoney Obtém o valor da coluna especificada como um SqlMoney.
Método público GetSqlSingle Obtém o valor da coluna especificada como um SqlSingle.
Método público GetSqlString Obtém o valor da coluna especificada como um SqlString.
Método público GetString Obtém o valor da coluna especificada como uma cadeia de caracteres. (Substitui DbDataReader.GetString(Int32).)
Método público GetType (herança de Object)
Método público GetValue Obtém o valor da coluna no ordinal especificado em seu formato nativo. (Substitui DbDataReader.GetValue(Int32).)
Método público GetValues Obtém todas as colunas de atributo da linha atual. (Substitui DbDataReader.GetValues(array<Object[]).)
Método público InitializeLifetimeService (herança de MarshalByRefObject)
Método protegido IsCommandBehavior Determina se o CommandBehavior corresponde ao deste SqlCeDataReader.
Método público IsDBNull Obtém um valor que indica se a coluna contém valores inexistentes ou ausentes. (Substitui DbDataReader.IsDBNull(Int32).)
Método protegido MemberwiseClone() (herança de Object)
Método protegido MemberwiseClone(Boolean) (herança de MarshalByRefObject)
Método público NextResult Sem suporte no Provedor de Dados do .NET Compact Framework para SQL Server Compact. (Substitui DbDataReader.NextResult().)
Método protegido OnMove Infraestrutura.
Método público Read Avança o SqlCeDataReader para o próximo registro. (Substitui DbDataReader.Read().)
Método público Seek Coloca o SqlCeDataReader no registro com valores indexados que correspondem aos parâmetros especificados.
Método público ToString (herança de Object)

Início

Implementações de interfaces explícitas

  Nome Descrição
Implementações de interfaces explícitasMétodo privado IDataRecord.GetData (herança de DbDataReader)

Início

Comentários

Para criar um SqlCeDataReader, chame o método ExecuteReader do objeto SqlCeCommand, em vez de usar diretamente um construtor.

Enquanto o SqlCeDataReader está sendo usado, a SqlCeConnection associada está ocupada atendendo o SqlCeDataReader. Neste estado, você pode criar vários leitores na mesma conexão.

As alterações feitas a um conjunto de resultados por outro processo ou thread enquanto os dados são lidos podem ser visíveis para o usuário do SqlCeDataReader; contudo, o comportamento preciso depende do quando ocorrem.

IsClosed e RecordsAffected são as únicas propriedades que você pode chamar depois que o SqlCeDataReader é fechado. Apesar de ser possível acessar propriedade RecordsAffected a qualquer momento enquanto o SqlCeDataReader existir, sempre chame Close antes de retornar o valor de RecordsAffected para assegurar um valor de retorno preciso.

Exemplos

O exemplo a seguir cria uma SqlCeConnection, um SqlCeCommand e um SqlCeDataReader. O exemplo lê os dados e os grava no console; em seguida, fecha o SqlCeDataReader e a SqlCeConnection.

Dim conn As SqlCeConnection = Nothing
Dim cmd As SqlCeCommand = Nothing
Dim rdr As SqlCeDataReader = Nothing

Try
    ' Open the connection and create a SQL command
    '
    conn = New SqlCeConnection("Data Source = AdventureWorks.sdf")
    conn.Open()

    cmd = New SqlCeCommand("SELECT * FROM DimEmployee", conn)

    rdr = cmd.ExecuteReader()

    ' Iterate through the results
    '
    While rdr.Read()
        Dim employeeID As Integer = rdr.GetInt32(0) ' or: rdr["EmployeeKey"];
        Dim lastName As String = rdr.GetString(5) ' or: rdr["FirstName"];
    End While

    ' Always dispose data readers and commands as soon as practicable
    '
    rdr.Close()
    cmd.Dispose()
Finally
    ' Close the connection when no longer needed
    '
    conn.Close()
End Try

SqlCeConnection conn = null;
SqlCeCommand cmd = null;
SqlCeDataReader rdr = null;

try
{
    // Open the connection and create a SQL command
    //
    conn = new SqlCeConnection("Data Source = AdventureWorks.sdf");
    conn.Open();

    cmd = new SqlCeCommand("SELECT * FROM DimEmployee", conn);

    rdr = cmd.ExecuteReader();

    // Iterate through the results
    //
    while (rdr.Read())
    {
        int employeeID = rdr.GetInt32(0);   // or: rdr["EmployeeKey"];
        string lastName = rdr.GetString(5); // or: rdr["FirstName"];
    }

    // Always dispose data readers and commands as soon as practicable
    //
    rdr.Close();
    cmd.Dispose();
}
finally
{
    // Close the connection when no longer needed
    //
    conn.Close();
}

Segurança de thread

Qualquer membro estático público (Shared no Microsoft Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.

Consulte também

Referência

Namespace System.Data.SqlServerCe