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)

'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.

	Nom	Description
	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

	Nom	Description
	ContainsListCollection	Infrastructure.
	Depth	Obtient une valeur indiquant la profondeur d'imbrication de la ligne actuelle. (hérité de SqlCeDataReader)
	FieldCount	Obtient le nombre de colonnes de la clause SELECT de la requête. (hérité de SqlCeDataReader)
	HasRows	Obtient une valeur qui indique si SqlCeDataReader contient une ou plusieurs lignes. (hérité de SqlCeDataReader)
	HiddenFieldCount	Infrastructure. (hérité de SqlCeDataReader)
	IsClosed	Indique si le lecteur de données est fermé. (hérité de SqlCeDataReader)
	Item[Int32]	Sert d'indexeur pour SqlCeResultSet. (remplace SqlCeDataReader.Item[Int32].)
	Item[String]	Sert d'indexeur pour SqlCeResultSet. (remplace SqlCeDataReader.Item[String].)
	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)
	ResultSetView	Utilisé lors de la liaison de SqlCeResultSet à un contrôle.
	Scrollable	Détermine si SqlCeResultSet est déroulant.
	Sensitivity	Détermine la sensibilité de SqlCeResultSet.
	Updatable	Détermine si les valeurs de SqlCeResultSet peuvent être modifiées.
	VisibleFieldCount	(hérité de DbDataReader)

Haut de la page

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

Haut de la page

	Nom	Description
	IListSource.ContainsListCollection
	IEnumerable.GetEnumerator
	IListSource.GetList
	IDataRecord.GetData	(hérité de DbDataReader)

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.

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

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.

Espace de noms System.Data.SqlServerCe