SqlCeCommand.CommandText 属性

获取或设置在数据源执行的 SQL 语句。

命名空间: System.Data.SqlServerCe
程序集: System.Data.SqlServerCe（在 system.data.sqlserverce.dll 中）

语法

声明
Public Overrides Property CommandText As String
用法
Dim instance As SqlCeCommand
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)

不适用。

属性值

将要执行的 SQL 语句或将要打开的基表的名称。默认值为空字符串。

备注

当 CommandType 属性设置为 TableDirect 时，CommandText 属性应设置为要访问的表的名称。TableDirect 访问是从 SQL Server Compact Edition 检索数据的最快捷方法。如果指定的任何表中包含任何特殊字符，则可能要求您使用转义符语法。当您调用“执行”(Execute) 方法之一时，将返回命名表的所有行和列。

如果当前连接正在执行“执行”(Execute) 或“获取”(fetch) 操作，则不能设置 Connection、CommandType 和 CommandText 属性。

当 CommandType 设置为 Text 时，SQL Server Compact Edition .NET Compact Framework 数据提供程序支持向 SqlCeCommand 调用的 SQL 语句传递参数的命名参数。例如：

SELECT * FROM Customers WHERE CustomerID = @customerID

SQL Server Compact Edition 数据提供程序也不支持批查询。命令的格式必须是：SELECT * FROM Customers，而不能是：SELECT * FROM Customers; SELECT * FROM Orders。如果您在使用为 System.Data.SqlClient 生成的代码，则必须相应地修改查询，使它们符合此限制。

示例

下面的示例创建一个 SqlCeCommand 并设置 CommandText 和其他属性。

Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
cmd.CommandType = CommandType.Text
cmd.UpdatedRowSource = UpdateRowSource.Both

SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
cmd.CommandType = CommandType.Text;
cmd.UpdatedRowSource = UpdateRowSource.Both;

平台

Windows 98, Windows Server 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

Windows Vista、Microsoft Windows XP SP2 和 Windows Server 2003 SP1 支持 Microsoft .NET Framework 3.0。

版本信息

.NET Framework

受以下版本支持：3.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

SqlCeCommand 类
SqlCeCommand 成员
System.Data.SqlServerCe 命名空间
Connection
CommandType