Version imprimable       Envoyer     
Cliquez pour évaluer et commenter
TechNet
Bibliothèque TechNet
SQL Server
SQL Server Compact 4.0
Référence technique de SQ...
Classe SqlCeResultSet
Réduire tout/Développer tout Réduire tout
Cette page est spécifique à
Microsoft Visual Studio 2010/.NET Framework 4

D'autres versions sont également disponibles pour :
Classe SqlCeResultSet

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

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)
Visual Basic (Déclaration)
Public Class SqlCeResultSet _
    Inherits SqlCeDataReader _
    Implements IEnumerable, IListSource
Visual Basic (Utilisation)
Dim instance As SqlCeResultSet
C#
public class SqlCeResultSet : SqlCeDataReader, 
    IEnumerable, IListSource
Visual C++
public ref class SqlCeResultSet : public SqlCeDataReader, 
    IEnumerable, IListSource
F#
type SqlCeResultSet =  
    class
        inherit SqlCeDataReader
        interface IEnumerable
        interface IListSource
    end
JScript
public class SqlCeResultSet extends SqlCeDataReader implements IEnumerable, IListSource

Le type SqlCeResultSet expose les membres suivants.

  NomDescription
Méthode protégéeSqlCeResultSetInformations 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
  NomDescription
Propriété protégéeContainsListCollectionInfrastructure.
Propriété publiqueDepthObtient une valeur indiquant la profondeur d'imbrication de la ligne actuelle. (hérité de SqlCeDataReader)
Propriété publiqueFieldCountObtient le nombre de colonnes de la clause SELECT de la requête. (hérité de SqlCeDataReader)
Propriété publiqueHasRowsObtient une valeur qui indique si SqlCeDataReader contient une ou plusieurs lignes. (hérité de SqlCeDataReader)
Propriété publiqueHiddenFieldCountInfrastructure. (hérité de SqlCeDataReader)
Propriété publiqueIsClosedIndique si le lecteur de données est fermé. (hérité de SqlCeDataReader)
Propriété publiqueItem[([(Int32])])Sert d'indexeur pour SqlCeResultSet. (remplace SqlCeDataReader..::.Item[([(Int32])]).)
Propriété publiqueItem[([(String])])Sert d'indexeur pour SqlCeResultSet. (remplace SqlCeDataReader..::.Item[([(String])]).)
Propriété publiqueRecordsAffectedObtient 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é publiqueResultSetViewUtilisé lors de la liaison de SqlCeResultSet à un contrôle.
Propriété publiqueScrollableDétermine si SqlCeResultSet est déroulant.
Propriété publiqueSensitivityDétermine la sensibilité de SqlCeResultSet.
Propriété publiqueUpdatableDétermine si les valeurs de SqlCeResultSet peuvent être modifiées.
Propriété publiqueVisibleFieldCount (hérité de DbDataReader)
Haut de la page
  NomDescription
Méthode publiqueCloseFerme l'objet SqlCeDataReader. (hérité de SqlCeDataReader)
Méthode publiqueCreateObjRef (hérité de MarshalByRefObject)
Méthode publiqueCreateRecordCrée une ligne sur le serveur et retourne un objet SqlCeUpdatableRecord.
Méthode publiqueDeleteSupprime l'enregistrement actif de la source de données sur le serveur.
Méthode publiqueDispose()()()Infrastructure. Libère les ressources utilisées par cet SqlCeDataReader. (hérité de SqlCeDataReader)
Méthode protégéeDispose(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 publiqueEquals (hérité de Object)
Méthode protégéeFinalizeLibè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 publiqueGetBooleanRetourne la valeur de la colonne à l'index spécifié sous la forme d'une valeur booléenne. (remplace SqlCeDataReader..::.GetBoolean(Int32).)
Méthode publiqueGetByteRetourne la valeur de la colonne à l'index spécifié sous la forme d'un octet. (remplace SqlCeDataReader..::.GetByte(Int32).)
Méthode publiqueGetBytesCopie 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 publiqueGetCharNon pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (hérité de SqlCeDataReader)
Méthode publiqueGetCharsCopie 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 publiqueGetData (hérité de DbDataReader)
Méthode publiqueGetDataTypeNameObtient le nom du type de données source. (hérité de SqlCeDataReader)
Méthode publiqueGetDateTimeRetourne la valeur de la colonne à l'index spécifié en tant que DateTime. (remplace SqlCeDataReader..::.GetDateTime(Int32).)
Méthode protégéeGetDbDataReader (hérité de DbDataReader)
Méthode publiqueGetDecimalRetourne la valeur de la colonne à l'index spécifié en tant que Double. (remplace SqlCeDataReader..::.GetDecimal(Int32).)
Méthode publiqueGetDoubleRetourne la valeur de la colonne à l'index spécifié en tant que Double. (remplace SqlCeDataReader..::.GetDouble(Int32).)
Méthode publiqueGetEnumeratorRetourne un IEnumerator qui peut être utilisé pour parcourir les lignes dans le lecteur de données. (remplace SqlCeDataReader..::.GetEnumerator()()().)
Méthode publiqueGetFieldTypeObtient le Type qui correspond au type de données de l'objet. (hérité de SqlCeDataReader)
Méthode publiqueGetFloatRetourne la valeur de la colonne à l'index spécifié en tant que Float. (remplace SqlCeDataReader..::.GetFloat(Int32).)
Méthode publiqueGetGuidRetourne la valeur de la colonne à l'index spécifié en tant que GUID. (remplace SqlCeDataReader..::.GetGuid(Int32).)
Méthode publiqueGetHashCode (hérité de Object)
Méthode publiqueGetInt16Retourne la valeur de la colonne à l'index spécifié en tant que Int16. (remplace SqlCeDataReader..::.GetInt16(Int32).)
Méthode publiqueGetInt32Retourne la valeur de la colonne à l'index spécifié en tant que Int32. (remplace SqlCeDataReader..::.GetInt32(Int32).)
Méthode publiqueGetInt64Retourne la valeur de la colonne à l'index spécifié en tant que Int64. (remplace SqlCeDataReader..::.GetInt64(Int32).)
Méthode publiqueGetLifetimeService (hérité de MarshalByRefObject)
Méthode protégéeGetListRetourne une instance de ResultSetView.
Méthode publiqueGetNameObtient le nom de la colonne spécifiée. (hérité de SqlCeDataReader)
Méthode publiqueGetOrdinalObtient le numéro de la colonne, en fonction du nom de la colonne. (hérité de SqlCeDataReader)
Méthode publiqueGetProviderSpecificFieldTypeObtient un Object qui est une représentation du type de champ spécifique au fournisseur sous-jacent. (hérité de SqlCeDataReader)
Méthode publiqueGetProviderSpecificValue (hérité de DbDataReader)
Méthode publiqueGetProviderSpecificValues (hérité de DbDataReader)
Méthode publiqueGetSchemaTableRetourne DataTable qui décrit les métadonnées de la colonne de SqlCeDataReader. (hérité de SqlCeDataReader)
Méthode publiqueGetSqlBinaryRetourne la valeur de la colonne à l'index spécifié en tant que type SqlBinary. (remplace SqlCeDataReader..::.GetSqlBinary(Int32).)
Méthode publiqueGetSqlBooleanRetourne la valeur de la colonne à l'index spécifié en tant que type SqlBoolean. (remplace SqlCeDataReader..::.GetSqlBoolean(Int32).)
Méthode publiqueGetSqlByteRetourne la valeur de la colonne à l'index spécifié en tant que type SqlByte. (remplace SqlCeDataReader..::.GetSqlByte(Int32).)
Méthode publiqueGetSqlDateTimeRetourne la valeur de la colonne à l'index spécifié en tant que type SqlDateTime. (remplace SqlCeDataReader..::.GetSqlDateTime(Int32).)
Méthode publiqueGetSqlDecimalRetourne la valeur de la colonne à l'index spécifié en tant que type SqlDecimal. (remplace SqlCeDataReader..::.GetSqlDecimal(Int32).)
Méthode publiqueGetSqlDoubleRetourne la valeur de la colonne à l'index spécifié en tant que type SqlDouble. (remplace SqlCeDataReader..::.GetSqlDouble(Int32).)
Méthode publiqueGetSqlGuidRetourne la valeur de la colonne à l'index spécifié en tant que type SqlGuid. (remplace SqlCeDataReader..::.GetSqlGuid(Int32).)
Méthode publiqueGetSqlInt16Retourne la valeur de la colonne à l'index spécifié en tant que type SqlInt16. (remplace SqlCeDataReader..::.GetSqlInt16(Int32).)
Méthode publiqueGetSqlInt32Retourne la valeur de la colonne à l'index spécifié en tant que type SqlInt32. (remplace SqlCeDataReader..::.GetSqlInt32(Int32).)
Méthode publiqueGetSqlInt64Retourne la valeur de la colonne à l'index spécifié en tant que type SqlInt64. (remplace SqlCeDataReader..::.GetSqlInt64(Int32).)
Méthode publiqueGetSqlMetaDataRetourne les informations de métadonnées associées à la colonne spécifiée.
Méthode publiqueGetSqlMoneyRetourne la valeur de la colonne à l'index spécifié en tant que type SqlMoney. (remplace SqlCeDataReader..::.GetSqlMoney(Int32).)
Méthode publiqueGetSqlSingleRetourne la valeur de la colonne à l'index spécifié en tant que type SqlSingle. (remplace SqlCeDataReader..::.GetSqlSingle(Int32).)
Méthode publiqueGetSqlStringRetourne la valeur de la colonne à l'index spécifié en tant que type SqlString. (remplace SqlCeDataReader..::.GetSqlString(Int32).)
Méthode publiqueGetStringRetourne la valeur de la colonne à l'index spécifié en tant que type String. (remplace SqlCeDataReader..::.GetString(Int32).)
Méthode publiqueGetType (hérité de Object)
Méthode publiqueGetValueRetourne la valeur du champ spécifié. (remplace SqlCeDataReader..::.GetValue(Int32).)
Méthode publiqueGetValuesRécupère un tableau de tous les champs de l'enregistrement spécifié. (remplace SqlCeDataReader..::.GetValues(array<Object>[]()[]).)
Méthode publiqueInitializeLifetimeService (hérité de MarshalByRefObject)
Méthode publiqueInsert(SqlCeUpdatableRecord)Insère le SqlCeUpdatableRecord spécifié dans le jeu de lignes sous-jacent.
Méthode publiqueInsert(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éeIsCommandBehaviorDétermine si le CommandBehavior spécifié correspond à cet SqlCeDataReader. (hérité de SqlCeDataReader)
Méthode publiqueIsDBNullDétermine si le champ à la position ordinale spécifiée est null. (remplace SqlCeDataReader..::.IsDBNull(Int32).)
Méthode publiqueIsSetAsDefaultDé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éeMemberwiseClone()()() (hérité de Object)
Méthode protégéeMemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode publiqueNextResultNon pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (hérité de SqlCeDataReader)
Méthode protégéeOnMoveInfrastructure. (remplace SqlCeDataReader..::.OnMove()()().)
Méthode publiqueReadAvance SqlCeDataReader jusqu'à l'enregistrement suivant. (hérité de SqlCeDataReader)
Méthode publiqueReadAbsoluteDéplace le lecteur vers un enregistrement spécifique dans ResultSet.
Méthode publiqueReadFirstPositionne le lecteur au premier enregistrement de ResultSet.
Méthode publiqueReadLastPositionne le lecteur au dernier enregistrement de ResultSet.
Méthode publiqueReadPreviousPositionne le lecteur à l'enregistrement précédant l'enregistrement actif.
Méthode publiqueReadRelativeDéplace le lecteur du nombre spécifié à partir de la position actuelle.
Méthode publiqueSeekPlace SqlCeDataReader sur l'enregistrement ayant des valeurs indexées qui correspondent aux paramètres spécifiés. (hérité de SqlCeDataReader)
Méthode publiqueSetBooleanAffecte à la colonne spécifiée la valeur booléenne passée.
Méthode publiqueSetByteAffecte à la colonne spécifiée la valeur Byte passée.
Méthode publiqueSetBytesCopie 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 publiqueSetCharAffecte à la colonne spécifiée la valeur Char passée.
Méthode publiqueSetCharsCopie 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 publiqueSetDateTimeAffecte à la colonne spécifiée la valeur DateTime passée.
Méthode publiqueSetDecimalAffecte à la colonne spécifiée la valeur Decimal passée.
Méthode publiqueSetDefaultAffecte à la colonne spécifiée sa valeur par défaut.
Méthode publiqueSetDoubleAffecte à la colonne spécifiée la valeur Double passée.
Méthode publiqueSetFloatAffecte à la colonne spécifiée la valeur Float passée.
Méthode publiqueSetGuidAffecte à la colonne spécifiée la valeur Guid passée.
Méthode publiqueSetInt16Affecte à la colonne spécifiée la valeur Int16 passée.
Méthode publiqueSetInt32Affecte à la colonne spécifiée la valeur Int32 passée.
Méthode publiqueSetInt64Affecte à la colonne spécifiée la valeur Int64 passée.
Méthode publiqueSetObjectRefLie un objet à la colonne à la position spécifiée.
Méthode publiqueSetSqlBinaryAffecte à la colonne spécifiée la valeur SqlBinary passée.
Méthode publiqueSetSqlBooleanAffecte à la colonne spécifiée la valeur SqlBoolean passée.
Méthode publiqueSetSqlByteAffecte à la colonne spécifiée la valeur SqlByte passée.
Méthode publiqueSetSqlDateTimeAffecte à la colonne spécifiée la valeur SqlDateTime passée.
Méthode publiqueSetSqlDecimalAffecte à la colonne spécifiée la valeur SqlDecimal passée.
Méthode publiqueSetSqlDoubleAffecte à la colonne spécifiée la valeur SqlDouble passée.
Méthode publiqueSetSqlGuidAffecte à la colonne spécifiée la valeur SqlGuid passée.
Méthode publiqueSetSqlInt16Affecte à la colonne spécifiée la valeur SqlInt16 passée.
Méthode publiqueSetSqlInt32Affecte à la colonne spécifiée la valeur SqlInt32 passée.
Méthode publiqueSetSqlInt64Affecte à la colonne spécifiée la valeur SqlInt64 passée.
Méthode publiqueSetSqlMoneyAffecte à la colonne spécifiée la valeur SqlMoney passée.
Méthode publiqueSetSqlSingleAffecte à la colonne spécifiée la valeur SqlSingle passée.
Méthode publiqueSetSqlStringAffecte à la colonne spécifiée la valeur SqlString passée.
Méthode publiqueSetStringAffecte à la colonne spécifiée la valeur String passée.
Méthode publiqueSetValueAffecte à la colonne spécifiée la valeur passée.
Méthode publiqueSetValuesAffecte à chacun des champs de l'enregistrement spécifié la valeur correspondante dans le tableau spécifié.
Méthode publiqueToString (hérité de Object)
Méthode publiqueUpdateEnvoie les modifications de l'enregistrement actif vers la ligne sous-jacente sur le serveur.
Haut de la page

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.

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.

Visual Basic
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
C#
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();
}
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.
© 2012 Microsoft. Tous droits réservés. Conditions d'utilisation | Marques | Confidentialité
Page view tracker