共用方式為

SqlCommand.CommandText 屬性

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
來源:
System.Data.SqlClient.notsupported.cs

取得或設定在資料來源執行的 Transact-SQL 語句、資料表名稱或儲存程序。

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

屬性值

String

Transact-SQL 要執行的語句或儲存程序。 預設值是空字串。

實作

CommandText
屬性
DataSysDescriptionAttribute

範例

以下範例會建立 並 SqlCommand 設定其部分性質。

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

備註

當屬性 CommandType 設定為 StoredProcedure時， CommandText 該屬性應設定為儲存程序的名稱。 如果儲存程序名稱包含特殊字元，使用者可能需要使用跳脫字元語法。 當你呼叫其中一個 Execute 方法時，指令會執行這個儲存程序。

Microsoft .NET Framework Data Provider for SQL Server 不支援用問號（？）佔位符來傳遞參數給 Transact-SQL 語句或由 命令 CommandType.Text呼叫的儲存程序。 此時必須使用命名參數。 例如：

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

欲了解更多資訊，請參閱 「參數與參數資料型態的配置」。

適用於

另請參閱