Proprietà SqlCeCommand.CommandText
Ottiene o imposta un'istruzione SQL da eseguire nell'origine dati.
Spazio dei nomi System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Sintassi
'Dichiarazione
Public Overrides Property CommandText As String
Get
Set
'Utilizzo
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)
Valore proprietà
Tipo: System.String
Istruzione SQL da eseguire o nome della tabella di base da aprire. Il valore predefinito è una stringa vuota.
Implementa
Osservazioni
Se la proprietà CommandType è impostata su TableDirect, la proprietà CommandText deve essere impostata sul nome della tabella cui eseguire l'accesso. L'accesso di tipo TableDirect costituisce il modo più rapido per recuperare dati da SQL Server Compact. Potrebbe essere necessario utilizzare la sintassi dei caratteri di escape, se nel nome di una o più tabelle sono contenuti caratteri speciali. Quando si chiama uno dei metodi Execute, verranno restituite tutte le righe e le colonne della tabella o delle tabelle denominate.
Non è possibile impostare le proprietà Connection, CommandType e CommandText se nella connessione corrente è attualmente in esecuzione un'operazione di esecuzione o recupero.
Il provider di dati .NET Compact Framework per SQL Server Compact supporta i parametri denominati per il passaggio di parametri a un'istruzione SQL chiamata da una classe SqlCeCommand quando la proprietà CommandType è impostata su Text. Esempio:
SELECT * FROM Customers WHERE CustomerID = @customerID
Il provider di dati per SQL Server Compact non supporta l'esecuzione di query raggruppate in batch. È necessario che i comandi siano nel formato: SELECT * FROM Customers anziché SELECT * FROM Customers; SELECT * FROM Orders. Se si utilizza un codice generato per System.Data.SqlClient, può essere necessario modificare le query in modo conforme a questa restrizione.
Quando si utilizza la replica abilitata per RDA, è necessario specificare i nomi di colonna per le query INSERT. Le tabelle con rilevamento RDA contengono colonne generate dal sistema che modificheranno il conteggio delle colonne previste per la query. Se non si specificano i nomi di colonna e il numero di colonne nell'istruzione INSERT è diverso da quello delle colonne presenti nella tabella, l'istruzione INSERT non verrà eseguita in modo corretto.
Esempi
Nell'esempio che segue viene creato un oggetto SqlCeCommand e viene impostata la proprietà CommandText e altre proprietà.
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;