Classe SqlCeCommand

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

Hiérarchie d'héritage

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)

Syntaxe

'Déclaration
Public NotInheritable Class SqlCeCommand _
    Inherits DbCommand _
    Implements ICloneable
'Utilisation
Dim instance As SqlCeCommand

public sealed class SqlCeCommand : DbCommand, 
    ICloneable

public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable

[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end

public final class SqlCeCommand extends DbCommand implements ICloneable

Le type SqlCeCommand expose les membres suivants.

Constructeurs

	Nom	Description
	SqlCeCommand()	Initialise une nouvelle instance de la classe SqlCeCommand.
	SqlCeCommand(String)	Initialise une nouvelle instance de la classe SqlCeCommand avec le texte de la requête.
	SqlCeCommand(String, SqlCeConnection)	Initialise une nouvelle instance de la classe SqlCeCommand avec le texte de la requête et SqlCeConnection.
	SqlCeCommand(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

Propriétés

	Nom	Description
	CanRaiseEvents	(hérité de Component)
	CommandText	Obtient ou définit une instruction SQL à exécuter au niveau de la source de données. (remplace DbCommand.CommandText.)
	CommandTimeout	Obtient 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.)
	CommandType	Obtient ou définit une valeur indiquant la manière dont la propriété CommandText est interprétée. (remplace DbCommand.CommandType.)
	Connection	Obtient ou définit le SqlCeConnection utilisé par cette instance de SqlCeCommand.
	Container	(hérité de Component)
	DbConnection	(hérité de DbCommand)
	DbParameterCollection	(hérité de DbCommand)
	DbTransaction	(hérité de DbCommand)
	DesignMode	(hérité de Component)
	DesignTimeVisible	Get retourne toujours false ; set lève toujours NotSupportedException. (remplace DbCommand.DesignTimeVisible.)
	Events	(hérité de Component)
	IndexName	Spécifie l'index à ouvrir.
	Parameters	Obtient le SqlCeParameterCollection.
	Site	(hérité de Component)
	Transaction	Obtient ou définit la transaction dans laquelle SqlCeCommand s'exécute.
	UpdatedRowSource	Obtient 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

Méthodes

	Nom	Description
	Cancel	Tente d'annuler l'exécution de SqlCeCommand. (remplace DbCommand.Cancel().)
	CreateDbParameter	(hérité de DbCommand)
	CreateObjRef	(hérité de MarshalByRefObject)
	CreateParameter	Crée une nouvelle instance d'un objet SqlCeParameter.
	Dispose()	(hérité de Component)
	Dispose(Boolean)	(hérité de Component)
	Equals	(hérité de Object)
	ExecuteDbDataReader	(hérité de DbCommand)
	ExecuteNonQuery	Exécute une instruction SQL sur SqlCeConnection et retourne le nombre de lignes affectées. (remplace DbCommand.ExecuteNonQuery().)
	ExecuteReader()	Envoie CommandText à Connection et génère SqlCeDataReader.
	ExecuteReader(CommandBehavior)	Envoie CommandText à Connection et génère SqlCeDataReader à l'aide d'une valeur CommandBehavior.
	ExecuteResultSet(ResultSetOptions)	Envoie CommandText à Connection et génère SqlCeResultSet en utilisant ResultSetOptions.
	ExecuteResultSet(ResultSetOptions, SqlCeResultSet)	Envoie CommandText à Connection et génère SqlCeResultSet en utilisant ResultSetOptions.
	ExecuteScalar	Exé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().)
	Finalize	(hérité de Component)
	GetHashCode	(hérité de Object)
	GetLifetimeService	(hérité de MarshalByRefObject)
	GetService	(hérité de Component)
	GetType	(hérité de Object)
	InitializeLifetimeService	(hérité de MarshalByRefObject)
	MemberwiseClone()	(hérité de Object)
	MemberwiseClone(Boolean)	(hérité de MarshalByRefObject)
	Prepare	Crée une version préparée (ou compilée) de la commande dans la source de données. (remplace DbCommand.Prepare().)
	SetRange	Restreint le jeu de lignes qui sera lu par SqlCeDataReader.
	ToString	(hérité de Component)

Haut de la page

Événements

	Nom	Description
	Disposed	(hérité de Component)

Haut de la page

Implémentations d'interfaces explicites

	Nom	Description
	ICloneable.Clone
	IDbCommand.Connection	(hérité de DbCommand)
	IDbCommand.CreateParameter	(hérité de DbCommand)
	IDbCommand.ExecuteReader()	(hérité de DbCommand)
	IDbCommand.ExecuteReader(CommandBehavior)	(hérité de DbCommand)
	IDbCommand.Parameters	(hérité de DbCommand)
	IDbCommand.Transaction	(hérité de DbCommand)

Haut de la page

Notes

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.

Exemples

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

SqlCeDataAdapter

SqlCeConnection