SqlCommand.CommandText 属性
获取或设置要对数据源执行的 Transact-SQL 语句或存储过程。
**命名空间:**System.Data.SqlClient
**程序集:**System.Data(在 system.data.dll 中)
语法
声明
Public Overrides Property CommandText As String
用法
Dim instance As SqlCommand
Dim value As String
value = instance.CommandText
instance.CommandText = value
public override string CommandText { get; set; }
public:
virtual property String^ CommandText {
String^ get () override;
void set (String^ value) override;
}
/** @property */
public String get_CommandText ()
/** @property */
public void set_CommandText (String value)
public override function get CommandText () : String
public override function set CommandText (value : String)
属性值
要执行的 Transact-SQL 语句或存储过程。默认为空字符串。
备注
当 CommandType 属性设置为 StoredProcedure 时,CommandText 属性应设置为存储过程的名称。如果存储过程名称包含任何特殊字符,则可能会要求用户使用转义符语法。当调用 Execute 方法之一时,该命令将执行此存储过程。
用于 SQL Server 的 Microsoft .NET Framework 数据提供程序不支持在向通过 CommandType.Text 的命令调用的 Transact-SQL 语句或存储过程传递参数时使用问号 (?) 占位符。在这种情况下,必须使用命名的参数。例如:
SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID
有关更多信息,请参见 将存储过程用于命令。
示例
下面的示例创建一个 SqlCommand 并设置它的一些属性。
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
public void CreateCommand()
{
SqlCommand command = new SqlCommand();
command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
command.CommandTimeout = 15;
command.CommandType = CommandType.Text;
}
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求。
版本信息
.NET Framework
受以下版本支持:2.0、1.1、1.0
.NET Compact Framework
受以下版本支持:2.0、1.0
请参见
参考
SqlCommand 类
SqlCommand 成员
System.Data.SqlClient 命名空间