Compartilhar via


Classe SqlCeResultSet

Um cursor que pode ser atualizado, rolado e ligado.

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 SqlCeResultSet _
    Inherits SqlCeDataReader _
    Implements IEnumerable, IListSource
'Uso
Dim instance As SqlCeResultSet
public class SqlCeResultSet : SqlCeDataReader, 
    IEnumerable, IListSource
public ref class SqlCeResultSet : public SqlCeDataReader, 
    IEnumerable, IListSource
type SqlCeResultSet =  
    class
        inherit SqlCeDataReader
        interface IEnumerable
        interface IListSource
    end
public class SqlCeResultSet extends SqlCeDataReader implements IEnumerable, IListSource

O tipo SqlCeResultSet expõe os membros a seguir.

Construtores

  Nome Descrição
Método protegido SqlCeResultSet Segurança crítica. Não usar. Para criar um SqlCeResultSet, chame o método ExecuteResultSet(ResultSetOptions) do SqlCeCommand.

Início

Propriedades

  Nome Descrição
Propriedade protegida ContainsListCollection Infraestrutura.
Propriedade pública Depth Obtém um valor que indica a profundidade do aninhamento da linha atual. (herança de SqlCeDataReader)
Propriedade pública FieldCount Obtém o número de colunas na cláusula SELECT da consulta. (herança de SqlCeDataReader)
Propriedade pública HasRows Obtém um valor que indica se SqlCeDataReader contém uma ou mais linhas (herança de SqlCeDataReader)
Propriedade pública HiddenFieldCount Infraestrutura. (herança de SqlCeDataReader)
Propriedade pública IsClosed Indica se o leitor de dados está fechado. (herança de SqlCeDataReader)
Propriedade pública Item[Int32] Serve como um indexador do SqlCeResultSet. (Substitui SqlCeDataReader.Item[Int32].)
Propriedade pública Item[String] Serve como um indexador do SqlCeResultSet. (Substitui SqlCeDataReader.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. (herança de SqlCeDataReader)
Propriedade pública ResultSetView Usado ao ligar dados de um SqlCeResultSet a um controle.
Propriedade pública Scrollable Determina se o SqlCeResultSet é rolável.
Propriedade pública Sensitivity Determina a sensibilidade do SqlCeResultSet.
Propriedade pública Updatable Determina se os valores no SqlCeResultSet podem ser modificados.
Propriedade pública VisibleFieldCount (herança de DbDataReader)

Início

Métodos

  Nome Descrição
Método público Close Fecha o objeto SqlCeDataReader. (herança de SqlCeDataReader)
Método público CreateObjRef (herança de MarshalByRefObject)
Método público CreateRecord Cria uma nova linha no servidor e retorna um objeto SqlCeUpdatableRecord.
Método público Delete Exclui o registro atual da fonte de dados no servidor.
Método público Dispose() Infraestrutura. Libera os recursos consumidos por este SqlCeDataReader. (herança de SqlCeDataReader)
Método protegido Dispose(Boolean) Libera os recursos não gerenciados usados por este SqlCeDataReader e, opcionalmente, libera também os recursos gerenciados. (herança de SqlCeDataReader)
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. (herança de SqlCeDataReader)
Método público GetBoolean Retorna o valor da coluna no índice especificado como um valor Boolean. (Substitui SqlCeDataReader.GetBoolean(Int32).)
Método público GetByte Retorna o valor da coluna no índice especificado como um byte. (Substitui SqlCeDataReader.GetByte(Int32).)
Método público GetBytes Copia um comprimento de bytes no buffer, iniciando em uma posição especificada no campo especificado. (Substitui SqlCeDataReader.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. (herança de SqlCeDataReader)
Método público GetChars Copia um comprimento de caracteres no buffer, iniciando em uma posição especificada no campo especificado. (Substitui SqlCeDataReader.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. (herança de SqlCeDataReader)
Método público GetDateTime Retorna o valor da coluna no índice especificado como DateTime. (Substitui SqlCeDataReader.GetDateTime(Int32).)
Método protegido GetDbDataReader (herança de DbDataReader)
Método público GetDecimal Retorna o valor da coluna no índice especificado como Double. (Substitui SqlCeDataReader.GetDecimal(Int32).)
Método público GetDouble Retorna o valor da coluna no índice especificado como Double. (Substitui SqlCeDataReader.GetDouble(Int32).)
Método público GetEnumerator Retorna um IEnumerator que pode ser usado para fazer a iteração pelas linhas no leitor de dados. (Substitui SqlCeDataReader.GetEnumerator().)
Método público GetFieldType Obtém o Type que é o tipo de dados do objeto. (herança de SqlCeDataReader)
Método público GetFloat Retorna o valor da coluna no índice especificado como Float. (Substitui SqlCeDataReader.GetFloat(Int32).)
Método público GetGuid Retorna o valor da coluna no índice especificado como GUID. (Substitui SqlCeDataReader.GetGuid(Int32).)
Método público GetHashCode (herança de Object)
Método público GetInt16 Retorna o valor da coluna no índice especificado como Int16. (Substitui SqlCeDataReader.GetInt16(Int32).)
Método público GetInt32 Retorna o valor da coluna no índice especificado como Int32. (Substitui SqlCeDataReader.GetInt32(Int32).)
Método público GetInt64 Retorna o valor da coluna no índice especificado como Int64. (Substitui SqlCeDataReader.GetInt64(Int32).)
Método público GetLifetimeService (herança de MarshalByRefObject)
Método protegido GetList Retorna uma instância do ResultSetView.
Método público GetName Obtém nome da coluna especificada. (herança de SqlCeDataReader)
Método público GetOrdinal Obtém o ordinal da coluna, desde que seu nome seja fornecido. (herança de SqlCeDataReader)
Método público GetProviderSpecificFieldType Obtém um Object que é uma representação do tipo de campo específico do provedor subjacente. (herança de SqlCeDataReader)
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. (herança de SqlCeDataReader)
Método público GetSqlBinary Retorna o valor da coluna no índice especificado com o tipo SqlBinary. (Substitui SqlCeDataReader.GetSqlBinary(Int32).)
Método público GetSqlBoolean Retorna o valor da coluna no índice especificado com o tipo SqlBoolean. (Substitui SqlCeDataReader.GetSqlBoolean(Int32).)
Método público GetSqlByte Retorna o valor da coluna no índice especificado com o tipo SqlByte. (Substitui SqlCeDataReader.GetSqlByte(Int32).)
Método público GetSqlDateTime Retorna o valor da coluna no índice especificado com o tipo SqlDateTime. (Substitui SqlCeDataReader.GetSqlDateTime(Int32).)
Método público GetSqlDecimal Retorna o valor da coluna no índice especificado com o tipo SqlDecimal. (Substitui SqlCeDataReader.GetSqlDecimal(Int32).)
Método público GetSqlDouble Retorna o valor da coluna no índice especificado com o tipo SqlDouble. (Substitui SqlCeDataReader.GetSqlDouble(Int32).)
Método público GetSqlGuid Retorna o valor da coluna no índice especificado com o tipo SqlGuid. (Substitui SqlCeDataReader.GetSqlGuid(Int32).)
Método público GetSqlInt16 Retorna o valor da coluna no índice especificado com o tipo SqlInt16. (Substitui SqlCeDataReader.GetSqlInt16(Int32).)
Método público GetSqlInt32 Retorna o valor da coluna no índice especificado com o tipo SqlInt32. (Substitui SqlCeDataReader.GetSqlInt32(Int32).)
Método público GetSqlInt64 Retorna o valor da coluna no índice especificado com o tipo SqlInt64. (Substitui SqlCeDataReader.GetSqlInt64(Int32).)
Método público GetSqlMetaData Retorna as informações de metadados associadas à coluna especificada.
Método público GetSqlMoney Retorna o valor da coluna no índice especificado com o tipo SqlMoney. (Substitui SqlCeDataReader.GetSqlMoney(Int32).)
Método público GetSqlSingle Retorna o valor da coluna no índice especificado com o tipo SqlSingle. (Substitui SqlCeDataReader.GetSqlSingle(Int32).)
Método público GetSqlString Retorna o valor da coluna no índice especificado com o tipo SqlString. (Substitui SqlCeDataReader.GetSqlString(Int32).)
Método público GetString Retorna o valor da coluna no índice especificado com o tipo String. (Substitui SqlCeDataReader.GetString(Int32).)
Método público GetType (herança de Object)
Método público GetValue Retorna o valor do campo especificado. (Substitui SqlCeDataReader.GetValue(Int32).)
Método público GetValues Recupera uma matriz de todos os campos para o registro especificado. (Substitui SqlCeDataReader.GetValues(array<Object[]).)
Método público InitializeLifetimeService (herança de MarshalByRefObject)
Método público Insert(SqlCeUpdatableRecord) Insere o SqlCeUpdatableRecord especificado no conjunto de linhas subjacente.
Método público Insert(SqlCeUpdatableRecord, DbInsertOptions) Insere o SqlCeUpdatableRecord especificado no conjunto de linhas subjacente e especifica como o cursor é posicionado.
Método protegido IsCommandBehavior Determina se o CommandBehavior corresponde ao deste SqlCeDataReader. (herança de SqlCeDataReader)
Método público IsDBNull Determina se o campo na posição ordinal especificada é nulo. (Substitui SqlCeDataReader.IsDBNull(Int32).)
Método público IsSetAsDefault Determina se o campo na posição ordinal especificada está marcado para usar o valor padrão subjacente.
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. (herança de SqlCeDataReader)
Método protegido OnMove Infraestrutura. (Substitui SqlCeDataReader.OnMove().)
Método público Read Avança o SqlCeDataReader para o próximo registro. (herança de SqlCeDataReader)
Método público ReadAbsolute Move o leitor para um registro especificado no ResultSet.
Método público ReadFirst Posiciona o leitor no primeiro registro do ResultSet.
Método público ReadLast Posiciona o leitor no último registro do ResultSet.
Método público ReadPrevious Posiciona o leitor no registro anterior ao registro atual.
Método público ReadRelative Move o leitor da posição atual por um valor especificado.
Método público Seek Coloca o SqlCeDataReader no registro com valores indexados que correspondem aos parâmetros especificados. (herança de SqlCeDataReader)
Método público SetBoolean Define o valor da coluna especificada para o valor booliano passado.
Método público SetByte Define o valor da coluna especificada para o valor Byte passado.
Método público SetBytes Copia um comprimento de bytes do buffer especificado para a coluna especificada, iniciando no local especificado desse campo.
Método público SetChar Define o valor da coluna especificada para o valor Char passado.
Método público SetChars Copia um comprimento de caracteres do buffer especificado para a coluna especificada, iniciando no local especificado desse campo.
Método público SetDateTime Define o valor da coluna especificada para o valor DateTime passado.
Método público SetDecimal Define o valor da coluna especificada para o valor Decimal passado.
Método público SetDefault Define a coluna especificada com seu valor padrão.
Método público SetDouble Define o valor da coluna especificada para o valor Double passado.
Método público SetFloat Define o valor da coluna especificada para o valor Float passado.
Método público SetGuid Define o valor da coluna especificada para o valor Guid passado.
Método público SetInt16 Define o valor da coluna especificada para o valor Int16 passado.
Método público SetInt32 Define o valor da coluna especificada para o valor Int32 passado.
Método público SetInt64 Define o valor da coluna especificada para o valor Int64 passado.
Método público SetObjectRef Liga um objeto à coluna na posição especificada.
Método público SetSqlBinary Define o valor da coluna especificada para o valor SqlBinary passado.
Método público SetSqlBoolean Define o valor da coluna especificada para o valor SqlBoolean passado.
Método público SetSqlByte Define o valor da coluna especificada para o valor SqlByte passado.
Método público SetSqlDateTime Define o valor da coluna especificada para o valor SqlDateTime passado.
Método público SetSqlDecimal Define o valor da coluna especificada para o valor SqlDecimal passado.
Método público SetSqlDouble Define o valor da coluna especificada para o valor SqlDouble passado.
Método público SetSqlGuid Define o valor da coluna especificada para o valor SqlGuid passado.
Método público SetSqlInt16 Define o valor da coluna especificada para o valor SqlInt16 passado.
Método público SetSqlInt32 Define o valor da coluna especificada para o valor SqlInt32 passado.
Método público SetSqlInt64 Define o valor da coluna especificada para o valor SqlInt64 passado.
Método público SetSqlMoney Define o valor da coluna especificada para o valor SqlMoney passado.
Método público SetSqlSingle Define o valor da coluna especificada para o valor SqlSingle passado.
Método público SetSqlString Define o valor da coluna especificada para o valor SqlString passado.
Método público SetString Define o valor da coluna especificada para o valor String passado.
Método público SetValue Define o valor da coluna especificada para o valor passado.
Método público SetValues Define cada um dos campos no registro especificado com o valor correspondente na matriz especificada.
Método público ToString (herança de Object)
Método público Update Envia alterações do registro atual para a linha subjacente no servidor.

Início

Implementações de interfaces explícitas

  Nome Descrição
Implementações de interfaces explícitasPropriedade privada IListSource.ContainsListCollection
Implementações de interfaces explícitasMétodo privado IEnumerable.GetEnumerator
Implementações de interfaces explícitasMétodo privado IListSource.GetList
Implementações de interfaces explícitasMétodo privado IDataRecord.GetData (herança de DbDataReader)

Início

Comentários

Em versões anteriores do SQL Server Compact, para ligar controles a dados, era necessário usar um DataSet. O SqlCeDataReader fornece um desempenho melhor que um DataSet, mas trata-se de um cursor somente de encaminhamento, não atualizável. No SQL Server Compact, o SqlCeResultSet oferece uma combinação de funcionalidades: a capacidade de atualização e rolagem do DataSet junto com um desempenho semelhante ao do SqlCeDataReader.

Para criar um SqlCeResultSet, chame o método ExecuteResultSet em vez de usar o construtor do objeto.

ResultSetOptions permite especificar as capacidade de rolagem e atualização e a sensibilidade (que determina se SqlCeResultSet vê as alterações feitas por ele mesmo ou por outros) de SqlCeResultSet.

A posição padrão de SqlCeDataReader é antes do primeiro registro. Para começar a acessar quaisquer dados, chame Read. A primeira chamada a Read posicionará o cursor no primeiro registro. O comportamento é diferente do método SqlCeResultSet.Read. A posição padrão de SqlCeResultSet é o primeiro registro. A chamada do método SqlCeResultSet.Read imediatamente após a criação de SqlCeResultSet moverá o cursor para o segundo registro.

Exemplos

No exemplo a seguir, é criado um novo banco de dados do SQL Server Compact. Em seguida, um SqlCeResultSet é inicializado para preencher o conjunto de dados com dados.

Dim conn As SqlCeConnection = Nothing

Try
    File.Delete("Test.sdf")

    Dim engine As New SqlCeEngine("Data Source = Test.sdf")
    engine.CreateDatabase()

    conn = New SqlCeConnection("Data Source = Test.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "CREATE TABLE myTable (col1 INT, col2 MONEY, col3 NVARCHAR(200))"
    cmd.ExecuteNonQuery()

    cmd.CommandText = "SELECT * FROM myTable"

    Dim rs As SqlCeResultSet = cmd.ExecuteResultSet(ResultSetOptions.Updatable Or ResultSetOptions.Scrollable)

    Dim rec As SqlCeUpdatableRecord = rs.CreateRecord()

    rec.SetInt32(0, 34)
    rec.SetDecimal(1, System.Convert.ToDecimal(44.66))
    rec.SetString(2, "Sample text")

    rs.Insert(rec)
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    conn.Close()
End Try
SqlCeConnection conn = null;

try
{
    File.Delete("Test.sdf");

    SqlCeEngine engine = new SqlCeEngine("Data Source = Test.sdf");
    engine.CreateDatabase();

    conn = new SqlCeConnection("Data Source = Test.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 INT, col2 MONEY, col3 NVARCHAR(200))";
    cmd.ExecuteNonQuery();

    cmd.CommandText = "SELECT * FROM myTable";

    SqlCeResultSet rs = cmd.ExecuteResultSet(ResultSetOptions.Updatable | 
        ResultSetOptions.Scrollable);

    SqlCeUpdatableRecord rec = rs.CreateRecord();

    rec.SetInt32(0, 34);
    rec.SetDecimal(1, (decimal)44.66);
    rec.SetString(2, "Sample text");

    rs.Insert(rec);
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    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