SqlCommand.CommandText 属性

定义

获取或设置要在数据源中执行的 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

属性值

要执行的 Transact-SQL 语句或存储过程。 默认值为一个空字符串。

实现

属性

示例

以下示例创建 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

有关详细信息,请参阅 配置参数和参数数据类型

适用于

另请参阅