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

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

Vedi anche