SqlCeCommand Class

Article
01/14/2011

Représente une instruction SQL à exécuter par rapport à une source de données.

Espace de noms: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (dans system.data.sqlserverce.dll)

Syntaxe

'Déclaration
Public NotInheritable Class SqlCeCommand
    Inherits DbCommand
    Implements ICloneable

public sealed class SqlCeCommand : DbCommand, ICloneable

public ref class SqlCeCommand sealed : public DbCommand, ICloneable

public final class SqlCeCommand extends DbCommand implements ICloneable

public final class SqlCeCommand extends DbCommand implements ICloneable

Remarques

Lorsqu'une instance de SqlCeCommand est créée, les propriétés de lecture/écriture prennent leurs valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le constructeur SqlCeCommand.

SqlCeCommand met en œuvre les méthodes suivantes qui exécutent des commandes au niveau d'une source de données :

Élément	Description
ExecuteReader	Exécute des commandes qui retournent des lignes.
ExecuteNonQuery	Exécute des commandes SQL telles que des instructions INSERT, DELETE et UPDATE.
ExecuteScalar	Récupère une valeur unique (par exemple, une valeur d'agrégation) d'une base de données.
ExecuteResultSet	Exécute des commandes et retourne un jeu de résultats.

Le fournisseur de données pour SQL Server Compact 3.5 ne prend pas en charge les requêtes automatisées. Les commandes doivent être de la forme suivante :

Select * from Customers et non Select * from Customers; Select * from Orders;

Si vous utilisez un code généré par System.Data.SqlClient, vous devrez peut-être modifier vos requêtes pour tenir compte de cette restriction.

SQL Server Compact 3.5 prend en charge plusieurs connexions simultanées aussi bien que plusieurs commandes qui partagent la même connexion. Cela signifie qu'il est possible d'avoir plusieurs instances de SqlCeDataReader sur la même connexion. Ce comportement diffère de celui de System.Data.SqlClient.

Si un SqlCeException irrécupérable est généré par la méthode exécutant SqlCeCommand, SqlCeConnection peut être fermé. Vous pouvez toutefois rouvrir la connexion et continuer.

Hiérarchie d'héritage

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

Exemple

L'exemple suivant utilise SqlCeCommand, ainsi que SqlCeConnection pour sélectionner des lignes dans une base de données.

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try

string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    conn.Close();
}

Sécurité des threads

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

Plateformes

Plateformes de développement

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0

Voir aussi

Référence

SqlCeCommand Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeConnection

Partager via