Condividi tramite


OleDbCommand.CommandText Proprietà

Definizione

Ottiene o imposta l'istruzione SQL o la stored procedure da eseguire all'origine dati.

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public override string CommandText { get; set; }
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
member this.CommandText : string with get, set
[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set
Public Overrides Property CommandText As String
Public Property CommandText As String

Valore della proprietà

Istruzione SQL o stored procedure da eseguire. Il valore predefinito è una stringa vuota.

Implementazioni

Attributi

Esempio

L'esempio seguente crea un oggetto OleDbCommand e imposta alcune delle relative proprietà.

public void CreateMyOleDbCommand()
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}
Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

Commenti

Quando la CommandType proprietà è impostata su StoredProcedure, la CommandType proprietà deve essere impostata sul nome della stored procedure. L'utente può essere richiesto di usare la sintassi dei caratteri di escape se il nome della stored procedure contiene eventuali caratteri speciali. Il comando esegue questa stored procedure quando si chiama uno dei Execute metodi.

Quando CommandType è impostato su TableDirect, la CommandType proprietà deve essere impostata sul nome della tabella o delle tabelle a cui accedere. L'utente può essere richiesto di usare la sintassi dei caratteri di escape se una delle tabelle denominate contiene eventuali caratteri speciali. Tutte le righe e le colonne della tabella o delle tabelle denominate verranno restituite quando si chiama uno dei Execute metodi.

Non è possibile impostare le Connectionproprietà , CommandTypee CommandText se la connessione corrente esegue un'operazione di esecuzione o recupero.

Il provider OLE DB.NET non supporta parametri denominati per il passaggio di parametri a un'istruzione SQL o a una stored procedure chiamata da un OleDbCommand quando CommandType è impostato su Text. In questo caso, è necessario utilizzare il segnaposto punto interrogativo (?). Ad esempio:

SELECT * FROM Customers WHERE CustomerID = ?

Pertanto, l'ordine in cui OleDbParameter gli oggetti vengono aggiunti all'oggetto OleDbParameterCollection deve corrispondere direttamente alla posizione del segnaposto del punto interrogativo per il parametro.

Per altre informazioni, vedere Configurazione di parametri e tipi di dati dei parametri.

Si applica a

Vedi anche