SqlCeCommand.CommandText Property

Obtient ou définit une instruction SQL à exécuter au niveau de la source de données.

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

Syntaxe

'Déclaration
Public Overrides Property CommandText As String

public override string CommandText { get; set; }

public:
virtual property String^ CommandText {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_CommandText ()

/** @property */
public void set_CommandText (String value)

public override function get CommandText () : String

public override function set CommandText (value : String)

Valeur de propriété

Instruction SQL à exécuter ou nom de la table de base à ouvrir. La valeur par défaut est une chaîne vide.

Remarques

Si la propriété CommandType a la valeur TableDirect, affectez le nom de la table à laquelle accéder à la propriété CommandText. L'accès à TableDirect est le moyen le plus rapide de récupérer des données à partir de SQL Server Compact 3.5. Vous pouvez être obligé d'utiliser la syntaxe du caractère d'échappement si une des tables nommées contient des caractères spéciaux. Toutes les lignes et les colonnes des tables nommées sont retournées lorsque vous appelez une des méthodes Execute.

Vous ne pouvez pas définir les propriétés Connection, CommandType et CommandText pendant que la connexion en cours effectue une opération d'exécution (Execute) ou d'extraction (Fetch).

Le fournisseur de données .NET Compact Framework pour SQL Server Compact 3.5 prend en charge les paramètres nommés pour passer des paramètres à une instruction SQL appelée par un SqlCeCommand lorsque CommandType a la valeur Texte. Par exemple :

SELECT * FROM Customers WHERE CustomerID = @customerID

Le fournisseur de données pour SQL Server Compact 3.5 ne prend pas non plus en charge les requêtes automatisées. Les commandes doivent avoir 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.

Spécifiez des noms de colonnes pour les requêtes INSERT lorsque vous utilisez la réplication RDA (Remote Data Access). En effet, les tables suivies par RDA contiennent des colonnes générées par le système qui modifient le nombre de colonnes que vous pouviez attendre pour votre requête. Si vous ne spécifiez pas de noms de colonnes et que le nombre de colonnes de l'instruction INSERT diffère de celui de la table, INSERT échoue.

Exemple

L'exemple suivant crée SqlCeCommand et définit la propriété CommandText, de même que d'autres propriétés.

Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
cmd.CommandType = CommandType.Text
cmd.UpdatedRowSource = UpdateRowSource.Both

SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
cmd.CommandType = CommandType.Text;
cmd.UpdatedRowSource = UpdateRowSource.Both;

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 Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace
Connection
CommandType