SqlCommand.CommandText Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Pacchetto:: System.Data.SqlClient v4.8.6

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta l'istruzione Transact-SQL, il nome di tabella 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 Transact-SQL o stored procedure da eseguire. Il valore predefinito è una stringa vuota.

Implementazioni

CommandText

Attributi: DataSysDescriptionAttribute

Esempio

Nell'esempio seguente viene creato un oggetto SqlCommand e vengono impostate alcune delle relative proprietà.

public void CreateCommand()
 {
    SqlCommand command = new SqlCommand();
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }

Public Sub CreateCommand()
    Dim command As New SqlCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

Commenti

Quando la CommandType proprietà è impostata su StoredProcedure, la CommandText 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 .

Il provider di dati Microsoft .NET Framework per SQL Server non supporta il segnaposto del punto interrogativo (?) per il passaggio di parametri a un'istruzione Transact-SQL o a una stored procedure chiamata da un comando di CommandType.Text. In questo caso, è necessario usare i parametri denominati. Ad esempio:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

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

Si applica a

Condividi tramite