Propriété SqlCeCommand.CommandText
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 (en System.Data.SqlServerCe.dll)
Syntaxe
'Déclaration
Public Overrides Property CommandText As String
Get
Set
'Utilisation
Dim instance As SqlCeCommand
Dim value As String
value = instance.CommandText
instance.CommandText = value
public override string CommandText { get; set; }
public:
virtual property String^ CommandText {
String^ get () override;
void set (String^ value) override;
}
abstract CommandText : string with get, set
override CommandText : string with get, set
override function get CommandText () : String
override function set CommandText (value : String)
Valeur de propriété
Type : System.String
Instruction SQL à exécuter ou nom de la table de base à ouvrir. La valeur par défaut est une chaîne vide.
Implémente
Notes
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. 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 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 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.
Exemples
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;