SqlCommand.CommandText Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

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 override string CommandText { get; set; }

member this.CommandText : string with get, set

Public Overrides Property CommandText As String

Valore della proprietà

String

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

Esempio

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

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

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

}

Commenti

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

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

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Per altre informazioni, vedere Configurazione dei parametri.