OleDbCommand.CommandText Proprietà

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Assembly:

System.Data.dll

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à

String

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

Implementazioni

CommandText

Attributi

DataSysDescriptionAttribute

Esempio

Nell'esempio seguente viene creato un oggetto OleDbCommand e vengono impostate 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. Se il nome della stored procedure contiene caratteri speciali, potrebbe essere necessario utilizzare la sintassi dei caratteri di escape. Il comando esegue questa stored procedure quando si chiama uno dei Execute metodi .

Quando CommandType è impostato su TableDirect, è necessario impostare la CommandType proprietà sul nome della tabella o delle tabelle a cui accedere. L'utente può essere necessario utilizzare la sintassi dei caratteri di escape se una delle tabelle denominate contiene 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 quando OleDbCommand CommandType è impostato su Text. In questo caso, è necessario usare il segnaposto punto interrogativo (?). Ad esempio:

SELECT * FROM Customers WHERE CustomerID = ?

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

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

Vedi anche

• Uso dei comandi