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 SqlCeCommand
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 SqlCeCommand

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

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

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Visual Basic (Déclaration)
Public NotInheritable Class SqlCeCommand _
    Inherits DbCommand _
    Implements ICloneable
Visual Basic (Utilisation)
Dim instance As SqlCeCommand
C#
public sealed class SqlCeCommand : DbCommand, 
    ICloneable
Visual C++
public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable
F#
[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end
JScript
public final class SqlCeCommand extends DbCommand implements ICloneable

Le type SqlCeCommand expose les membres suivants.

  NomDescription
Méthode publiqueSqlCeCommand()()()Initialise une nouvelle instance de la classe SqlCeCommand.
Méthode publiqueSqlCeCommand(String)Initialise une nouvelle instance de la classe SqlCeCommand avec le texte de la requête.
Méthode publiqueSqlCeCommand(String, SqlCeConnection)Initialise une nouvelle instance de la classe SqlCeCommand avec le texte de la requête et SqlCeConnection.
Méthode publiqueSqlCeCommand(String, SqlCeConnection, SqlCeTransaction)Initialise une nouvelle instance de la classe SqlCeCommand avec le texte de la requête, SqlCeConnection et SqlCeTransaction.
Haut de la page
  NomDescription
Propriété protégéeCanRaiseEvents (hérité de Component)
Propriété publiqueCommandTextObtient ou définit une instruction SQL à exécuter au niveau de la source de données. (remplace DbCommand..::.CommandText.)
Propriété publiqueCommandTimeoutObtient ou définit la durée d'attente qui précède le moment où il est mis fin à une tentative d'exécution d'une commande et où une erreur est générée. (remplace DbCommand..::.CommandTimeout.)
Propriété publiqueCommandTypeObtient ou définit une valeur indiquant la manière dont la propriété CommandText est interprétée. (remplace DbCommand..::.CommandType.)
Propriété publiqueConnectionObtient ou définit le SqlCeConnection utilisé par cette instance de SqlCeCommand.
Propriété publiqueContainer (hérité de Component)
Propriété protégéeDbConnection (hérité de DbCommand)
Propriété protégéeDbParameterCollection (hérité de DbCommand)
Propriété protégéeDbTransaction (hérité de DbCommand)
Propriété protégéeDesignMode (hérité de Component)
Propriété publiqueDesignTimeVisibleGet retourne toujours false ; set lève toujours NotSupportedException. (remplace DbCommand..::.DesignTimeVisible.)
Propriété protégéeEvents (hérité de Component)
Propriété publiqueIndexNameSpécifie l'index à ouvrir.
Propriété publiqueParametersObtient le SqlCeParameterCollection.
Propriété publiqueSite (hérité de Component)
Propriété publiqueTransactionObtient ou définit la transaction dans laquelle SqlCeCommand s'exécute.
Propriété publiqueUpdatedRowSourceObtient ou définit la manière dont les résultats des commandes sont appliqués à DataRow lorsqu'ils sont utilisés par la méthode Update de DbDataAdapter. Cette propriété ne doit pas être utilisée avec le fournisseur de données .NET Compact Framework pour SQL Server Compact. (remplace DbCommand..::.UpdatedRowSource.)
Haut de la page
  NomDescription
Méthode publiqueCancelTente d'annuler l'exécution de SqlCeCommand. (remplace DbCommand..::.Cancel()()().)
Méthode protégéeCreateDbParameter (hérité de DbCommand)
Méthode publiqueCreateObjRef (hérité de MarshalByRefObject)
Méthode publiqueCreateParameterCrée une nouvelle instance d'un objet SqlCeParameter.
Méthode publiqueDispose()()() (hérité de Component)
Méthode protégéeDispose(Boolean) (hérité de Component)
Méthode publiqueEquals (hérité de Object)
Méthode protégéeExecuteDbDataReader (hérité de DbCommand)
Méthode publiqueExecuteNonQueryExécute une instruction SQL sur SqlCeConnection et retourne le nombre de lignes affectées. (remplace DbCommand..::.ExecuteNonQuery()()().)
Méthode publiqueExecuteReader()()()Envoie CommandText à Connection et génère SqlCeDataReader.
Méthode publiqueExecuteReader(CommandBehavior)Envoie CommandText à Connection et génère SqlCeDataReader à l'aide d'une valeur CommandBehavior.
Méthode publiqueExecuteResultSet(ResultSetOptions)Envoie CommandText à Connection et génère SqlCeResultSet en utilisant ResultSetOptions.
Méthode publiqueExecuteResultSet(ResultSetOptions, SqlCeResultSet)Envoie CommandText à Connection et génère SqlCeResultSet en utilisant ResultSetOptions.
Méthode publiqueExecuteScalarExécute la requête et retourne la première colonne de la première ligne du jeu de résultats qui est retourné par la requête. Les colonnes ou lignes supplémentaires sont ignorées. (remplace DbCommand..::.ExecuteScalar()()().)
Méthode protégéeFinalize (hérité de Component)
Méthode publiqueGetHashCode (hérité de Object)
Méthode publiqueGetLifetimeService (hérité de MarshalByRefObject)
Méthode protégéeGetService (hérité de Component)
Méthode publiqueGetType (hérité de Object)
Méthode publiqueInitializeLifetimeService (hérité de MarshalByRefObject)
Méthode protégéeMemberwiseClone()()() (hérité de Object)
Méthode protégéeMemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode publiquePrepareCrée une version préparée (ou compilée) de la commande dans la source de données. (remplace DbCommand..::.Prepare()()().)
Méthode publiqueSetRangeRestreint le jeu de lignes qui sera lu par SqlCeDataReader.
Méthode publiqueToString (hérité de Component)
Haut de la page
  NomDescription
Événement publicDisposed (hérité de Component)
Haut de la page

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

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

Visual Basic
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
C#
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();
}
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