Classe SqlCeResultSet

  • Article

Curseur modifiable, déroulant et pouvant être lié.

Hiérarchie d'héritage

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

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
Public Class SqlCeResultSet _
    Inherits SqlCeDataReader _
    Implements IEnumerable, IListSource
'Utilisation
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

Le type SqlCeResultSet expose les membres suivants.

Constructeurs

  Nom Description
Méthode protégée SqlCeResultSet Informations critiques de sécurité. Ne pas utiliser ce nœud. Pour créer SqlCeResultSet, vous devez appeler la méthode ExecuteResultSet(ResultSetOptions) de SqlCeCommand.

Haut de la page

Propriétés

  Nom Description
Propriété protégée ContainsListCollection Infrastructure.
Propriété publique Depth Obtient une valeur indiquant la profondeur d'imbrication de la ligne actuelle. (hérité de SqlCeDataReader)
Propriété publique FieldCount Obtient le nombre de colonnes de la clause SELECT de la requête. (hérité de SqlCeDataReader)
Propriété publique HasRows Obtient une valeur qui indique si SqlCeDataReader contient une ou plusieurs lignes. (hérité de SqlCeDataReader)
Propriété publique HiddenFieldCount Infrastructure. (hérité de SqlCeDataReader)
Propriété publique IsClosed Indique si le lecteur de données est fermé. (hérité de SqlCeDataReader)
Propriété publique Item[Int32] Sert d'indexeur pour SqlCeResultSet. (remplace SqlCeDataReader.Item[Int32].)
Propriété publique Item[String] Sert d'indexeur pour SqlCeResultSet. (remplace SqlCeDataReader.Item[String].)
Propriété publique RecordsAffected Obtient le nombre de lignes modifiées, insérées ou supprimées par l'exécution de l'instruction SQL. (hérité de SqlCeDataReader)
Propriété publique ResultSetView Utilisé lors de la liaison de SqlCeResultSet à un contrôle.
Propriété publique Scrollable Détermine si SqlCeResultSet est déroulant.
Propriété publique Sensitivity Détermine la sensibilité de SqlCeResultSet.
Propriété publique Updatable Détermine si les valeurs de SqlCeResultSet peuvent être modifiées.
Propriété publique VisibleFieldCount (hérité de DbDataReader)

Haut de la page

Méthodes

  Nom Description
Méthode publique Close Ferme l'objet SqlCeDataReader. (hérité de SqlCeDataReader)
Méthode publique CreateObjRef (hérité de MarshalByRefObject)
Méthode publique CreateRecord Crée une ligne sur le serveur et retourne un objet SqlCeUpdatableRecord.
Méthode publique Delete Supprime l'enregistrement actif de la source de données sur le serveur.
Méthode publique Dispose() Infrastructure. Libère les ressources utilisées par cet SqlCeDataReader. (hérité de SqlCeDataReader)
Méthode protégée Dispose(Boolean) Libère les ressources non managées utilisées par cet SqlCeDataReader et libère éventuellement aussi les ressources managées. (hérité de SqlCeDataReader)
Méthode publique Equals (hérité de Object)
Méthode protégée Finalize Libère les ressources non managées et exécute d'autres opérations de nettoyage avant la récupération de SqlCeDataReader par le garbage collection. (hérité de SqlCeDataReader)
Méthode publique GetBoolean Retourne la valeur de la colonne à l'index spécifié sous la forme d'une valeur booléenne. (remplace SqlCeDataReader.GetBoolean(Int32).)
Méthode publique GetByte Retourne la valeur de la colonne à l'index spécifié sous la forme d'un octet. (remplace SqlCeDataReader.GetByte(Int32).)
Méthode publique GetBytes Copie une longueur d'octets dans la mémoire tampon, en démarrant à une position spécifiée dans le champ indiqué. (remplace SqlCeDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32).)
Méthode publique GetChar Non pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (hérité de SqlCeDataReader)
Méthode publique GetChars Copie une longueur de caractères dans la mémoire tampon, en démarrant à une position spécifiée dans le champ spécifié. (remplace SqlCeDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32).)
Méthode publique GetData (hérité de DbDataReader)
Méthode publique GetDataTypeName Obtient le nom du type de données source. (hérité de SqlCeDataReader)
Méthode publique GetDateTime Retourne la valeur de la colonne à l'index spécifié en tant que DateTime. (remplace SqlCeDataReader.GetDateTime(Int32).)
Méthode protégée GetDbDataReader (hérité de DbDataReader)
Méthode publique GetDecimal Retourne la valeur de la colonne à l'index spécifié en tant que Double. (remplace SqlCeDataReader.GetDecimal(Int32).)
Méthode publique GetDouble Retourne la valeur de la colonne à l'index spécifié en tant que Double. (remplace SqlCeDataReader.GetDouble(Int32).)
Méthode publique GetEnumerator Retourne un IEnumerator qui peut être utilisé pour parcourir les lignes dans le lecteur de données. (remplace SqlCeDataReader.GetEnumerator().)
Méthode publique GetFieldType Obtient le Type qui correspond au type de données de l'objet. (hérité de SqlCeDataReader)
Méthode publique GetFloat Retourne la valeur de la colonne à l'index spécifié en tant que Float. (remplace SqlCeDataReader.GetFloat(Int32).)
Méthode publique GetGuid Retourne la valeur de la colonne à l'index spécifié en tant que GUID. (remplace SqlCeDataReader.GetGuid(Int32).)
Méthode publique GetHashCode (hérité de Object)
Méthode publique GetInt16 Retourne la valeur de la colonne à l'index spécifié en tant que Int16. (remplace SqlCeDataReader.GetInt16(Int32).)
Méthode publique GetInt32 Retourne la valeur de la colonne à l'index spécifié en tant que Int32. (remplace SqlCeDataReader.GetInt32(Int32).)
Méthode publique GetInt64 Retourne la valeur de la colonne à l'index spécifié en tant que Int64. (remplace SqlCeDataReader.GetInt64(Int32).)
Méthode publique GetLifetimeService (hérité de MarshalByRefObject)
Méthode protégée GetList Retourne une instance de ResultSetView.
Méthode publique GetName Obtient le nom de la colonne spécifiée. (hérité de SqlCeDataReader)
Méthode publique GetOrdinal Obtient le numéro de la colonne, en fonction du nom de la colonne. (hérité de SqlCeDataReader)
Méthode publique GetProviderSpecificFieldType Obtient un Object qui est une représentation du type de champ spécifique au fournisseur sous-jacent. (hérité de SqlCeDataReader)
Méthode publique GetProviderSpecificValue (hérité de DbDataReader)
Méthode publique GetProviderSpecificValues (hérité de DbDataReader)
Méthode publique GetSchemaTable Retourne DataTable qui décrit les métadonnées de la colonne de SqlCeDataReader. (hérité de SqlCeDataReader)
Méthode publique GetSqlBinary Retourne la valeur de la colonne à l'index spécifié en tant que type SqlBinary. (remplace SqlCeDataReader.GetSqlBinary(Int32).)
Méthode publique GetSqlBoolean Retourne la valeur de la colonne à l'index spécifié en tant que type SqlBoolean. (remplace SqlCeDataReader.GetSqlBoolean(Int32).)
Méthode publique GetSqlByte Retourne la valeur de la colonne à l'index spécifié en tant que type SqlByte. (remplace SqlCeDataReader.GetSqlByte(Int32).)
Méthode publique GetSqlDateTime Retourne la valeur de la colonne à l'index spécifié en tant que type SqlDateTime. (remplace SqlCeDataReader.GetSqlDateTime(Int32).)
Méthode publique GetSqlDecimal Retourne la valeur de la colonne à l'index spécifié en tant que type SqlDecimal. (remplace SqlCeDataReader.GetSqlDecimal(Int32).)
Méthode publique GetSqlDouble Retourne la valeur de la colonne à l'index spécifié en tant que type SqlDouble. (remplace SqlCeDataReader.GetSqlDouble(Int32).)
Méthode publique GetSqlGuid Retourne la valeur de la colonne à l'index spécifié en tant que type SqlGuid. (remplace SqlCeDataReader.GetSqlGuid(Int32).)
Méthode publique GetSqlInt16 Retourne la valeur de la colonne à l'index spécifié en tant que type SqlInt16. (remplace SqlCeDataReader.GetSqlInt16(Int32).)
Méthode publique GetSqlInt32 Retourne la valeur de la colonne à l'index spécifié en tant que type SqlInt32. (remplace SqlCeDataReader.GetSqlInt32(Int32).)
Méthode publique GetSqlInt64 Retourne la valeur de la colonne à l'index spécifié en tant que type SqlInt64. (remplace SqlCeDataReader.GetSqlInt64(Int32).)
Méthode publique GetSqlMetaData Retourne les informations de métadonnées associées à la colonne spécifiée.
Méthode publique GetSqlMoney Retourne la valeur de la colonne à l'index spécifié en tant que type SqlMoney. (remplace SqlCeDataReader.GetSqlMoney(Int32).)
Méthode publique GetSqlSingle Retourne la valeur de la colonne à l'index spécifié en tant que type SqlSingle. (remplace SqlCeDataReader.GetSqlSingle(Int32).)
Méthode publique GetSqlString Retourne la valeur de la colonne à l'index spécifié en tant que type SqlString. (remplace SqlCeDataReader.GetSqlString(Int32).)
Méthode publique GetString Retourne la valeur de la colonne à l'index spécifié en tant que type String. (remplace SqlCeDataReader.GetString(Int32).)
Méthode publique GetType (hérité de Object)
Méthode publique GetValue Retourne la valeur du champ spécifié. (remplace SqlCeDataReader.GetValue(Int32).)
Méthode publique GetValues Récupère un tableau de tous les champs de l'enregistrement spécifié. (remplace SqlCeDataReader.GetValues(array<Object[]).)
Méthode publique InitializeLifetimeService (hérité de MarshalByRefObject)
Méthode publique Insert(SqlCeUpdatableRecord) Insère le SqlCeUpdatableRecord spécifié dans le jeu de lignes sous-jacent.
Méthode publique Insert(SqlCeUpdatableRecord, DbInsertOptions) Insère le SqlCeUpdatableRecord spécifié dans le jeu de lignes sous-jacent et spécifie la façon dont le curseur est positionné.
Méthode protégée IsCommandBehavior Détermine si le CommandBehavior spécifié correspond à cet SqlCeDataReader. (hérité de SqlCeDataReader)
Méthode publique IsDBNull Détermine si le champ à la position ordinale spécifiée est null. (remplace SqlCeDataReader.IsDBNull(Int32).)
Méthode publique IsSetAsDefault Détermine si le champ à la position ordinale spécifiée est marqué pour utiliser la valeur par défaut sous-jacente.
Méthode protégée MemberwiseClone() (hérité de Object)
Méthode protégée MemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode publique NextResult Non pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (hérité de SqlCeDataReader)
Méthode protégée OnMove Infrastructure. (remplace SqlCeDataReader.OnMove().)
Méthode publique Read Avance SqlCeDataReader jusqu'à l'enregistrement suivant. (hérité de SqlCeDataReader)
Méthode publique ReadAbsolute Déplace le lecteur vers un enregistrement spécifique dans ResultSet.
Méthode publique ReadFirst Positionne le lecteur au premier enregistrement de ResultSet.
Méthode publique ReadLast Positionne le lecteur au dernier enregistrement de ResultSet.
Méthode publique ReadPrevious Positionne le lecteur à l'enregistrement précédant l'enregistrement actif.
Méthode publique ReadRelative Déplace le lecteur du nombre spécifié à partir de la position actuelle.
Méthode publique Seek Place SqlCeDataReader sur l'enregistrement ayant des valeurs indexées qui correspondent aux paramètres spécifiés. (hérité de SqlCeDataReader)
Méthode publique SetBoolean Affecte à la colonne spécifiée la valeur booléenne passée.
Méthode publique SetByte Affecte à la colonne spécifiée la valeur Byte passée.
Méthode publique SetBytes Copie une longueur d'octets de la mémoire tampon spécifiée dans la colonne indiquée, en démarrant à l'emplacement spécifié dans ce champ.
Méthode publique SetChar Affecte à la colonne spécifiée la valeur Char passée.
Méthode publique SetChars Copie une longueur de caractères de la mémoire tampon spécifiée dans la colonne indiquée, en démarrant à l'emplacement spécifié dans ce champ.
Méthode publique SetDateTime Affecte à la colonne spécifiée la valeur DateTime passée.
Méthode publique SetDecimal Affecte à la colonne spécifiée la valeur Decimal passée.
Méthode publique SetDefault Affecte à la colonne spécifiée sa valeur par défaut.
Méthode publique SetDouble Affecte à la colonne spécifiée la valeur Double passée.
Méthode publique SetFloat Affecte à la colonne spécifiée la valeur Float passée.
Méthode publique SetGuid Affecte à la colonne spécifiée la valeur Guid passée.
Méthode publique SetInt16 Affecte à la colonne spécifiée la valeur Int16 passée.
Méthode publique SetInt32 Affecte à la colonne spécifiée la valeur Int32 passée.
Méthode publique SetInt64 Affecte à la colonne spécifiée la valeur Int64 passée.
Méthode publique SetObjectRef Lie un objet à la colonne à la position spécifiée.
Méthode publique SetSqlBinary Affecte à la colonne spécifiée la valeur SqlBinary passée.
Méthode publique SetSqlBoolean Affecte à la colonne spécifiée la valeur SqlBoolean passée.
Méthode publique SetSqlByte Affecte à la colonne spécifiée la valeur SqlByte passée.
Méthode publique SetSqlDateTime Affecte à la colonne spécifiée la valeur SqlDateTime passée.
Méthode publique SetSqlDecimal Affecte à la colonne spécifiée la valeur SqlDecimal passée.
Méthode publique SetSqlDouble Affecte à la colonne spécifiée la valeur SqlDouble passée.
Méthode publique SetSqlGuid Affecte à la colonne spécifiée la valeur SqlGuid passée.
Méthode publique SetSqlInt16 Affecte à la colonne spécifiée la valeur SqlInt16 passée.
Méthode publique SetSqlInt32 Affecte à la colonne spécifiée la valeur SqlInt32 passée.
Méthode publique SetSqlInt64 Affecte à la colonne spécifiée la valeur SqlInt64 passée.
Méthode publique SetSqlMoney Affecte à la colonne spécifiée la valeur SqlMoney passée.
Méthode publique SetSqlSingle Affecte à la colonne spécifiée la valeur SqlSingle passée.
Méthode publique SetSqlString Affecte à la colonne spécifiée la valeur SqlString passée.
Méthode publique SetString Affecte à la colonne spécifiée la valeur String passée.
Méthode publique SetValue Affecte à la colonne spécifiée la valeur passée.
Méthode publique SetValues Affecte à chacun des champs de l'enregistrement spécifié la valeur correspondante dans le tableau spécifié.
Méthode publique ToString (hérité de Object)
Méthode publique Update Envoie les modifications de l'enregistrement actif vers la ligne sous-jacente sur le serveur.

Haut de la page

Implémentations d'interfaces explicites

  Nom Description
Implémentation d'interface explicitePropriété privée IListSource.ContainsListCollection
Implémentation d'interface expliciteMéthode privée IEnumerable.GetEnumerator
Implémentation d'interface expliciteMéthode privée IListSource.GetList
Implémentation d'interface expliciteMéthode privée IDataRecord.GetData (hérité de DbDataReader)

Haut de la page

Notes

Dans les versions antérieures de SQL Server Compact, pour lier des contrôles aux données, vous deviez utiliser DataSet. Bien que SqlCeDataReader offre de meilleures performances que DataSet, il s'agit d'un curseur avant uniquement, non modifiable. Dans SQL Server Compact, SqlCeResultSet combine le caractère modifiable et déroulant de DataSet et les performances de SqlCeDataReader.

Pour créer SqlCeResultSet, vous devez appeler la méthode ExecuteResultSet, et non utiliser le constructeur de l'objet.

ResultSetOptions vous permet de spécifier le caractère déroulant, le caractère modifiable et la sensibilité (laquelle détermine si SqlCeResultSet voit les modifications apportées par lui-même ou d'autres) de SqlCeResultSet.

La position par défaut de SqlCeDataReader est antérieure au premier enregistrement. Pour commencer à accéder aux données, vous devez appeler Read. Le premier Read va positionner le curseur sur le premier enregistrement. Le comportement est différent de celui de la méthode SqlCeResultSet.Read. La position par défaut de SqlCeResultSet est le premier enregistrement. En appelant la méthode SqlCeResultSet.Read immédiatement après la création de SqlCeResultSet, le curseur va être déplacé sur le second enregistrement.

Exemples

Dans l'exemple suivant, une nouvelle base de données SQL Server Compact est créée. SqlCeResultSet est ensuite initialisé pour remplir le groupe de données avec des données.

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();
}

Sécurité des threads

Tout membre statique public (Shared en Microsoft Visual Basic) de ce type est thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Voir aussi

Référence

Espace de noms System.Data.SqlServerCe