SqlCeCommand.CommandText Property

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

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)

Valore proprietà

Istruzione SQL da eseguire o nome della tabella di base da aprire. Il valore predefinito è una stringa vuota.

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

Esempio

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;

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace
Connection
CommandType