SqlCommand.CommandText Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll
Pakiet:
System.Data.SqlClient v4.8.6

Pobiera lub ustawia instrukcję Języka Transact-SQL, nazwę tabeli lub procedurę składowaną do wykonania w źródle danych.

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

Wartość właściwości

String

Instrukcja Transact-SQL lub procedura składowana do wykonania. Wartość domyślna to pusty ciąg.

Implementuje

CommandText
Atrybuty
DataSysDescriptionAttribute

Przykłady

Poniższy przykład tworzy obiekt SqlCommand i ustawia niektóre z jego właściwości.

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

Uwagi

CommandType Gdy właściwość jest ustawiona na StoredProcedurewartość , CommandText właściwość powinna być ustawiona na nazwę procedury składowanej. Użytkownik może być zobowiązany do używania składni znaków ucieczki, jeśli nazwa procedury składowanej zawiera jakiekolwiek znaki specjalne. Polecenie wykonuje tę procedurę składowaną podczas wywoływania Execute jednej z metod.

Dostawca danych microsoft .NET Framework dla SQL Server nie obsługuje symbolu zastępczego znaku zapytania (?) do przekazywania parametrów do instrukcji Języka Transact-SQL lub procedury składowanej wywoływanej CommandType.Textprzez polecenie . W takim przypadku należy użyć nazwanych parametrów. Na przykład:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Aby uzyskać więcej informacji, zobacz Konfigurowanie parametrów i typów danych parametrów.

Dotyczy

Zobacz też