CommandText 属性 (ADO)

指示要针对提供程序发出的命令的文本。

设置和返回值

获取或设置一个包含提供程序命令的字符串值，例如 SQL 语句、表名、相对 URL 或存储过程调用。 默认为空字符串 ("")。

备注

使用 CommandText 属性设置或返回由 Command 对象表示的命令的文本。 通常这将是一条 SQL 语句，但也可以是提供者识别的任何其他类型的命令语句，例如存储过程调用。 SQL 语句必须是提供者的查询处理器支持的特定方言或版本。

如果在设置 CommandText 属性时 Command 对象的 Prepared 属性设置为 True 并且 Command 对象绑定到打开的连接，则 ADO 会在你调用 Execute 或 Open 方法时准备查询（即提供程序存储的查询的编译形式）。

根据 CommandType 属性设置，ADO 可能会更改 CommandText 属性。 你可以随时阅读 CommandText 属性以查看 ADO 在执行期间将使用的实际命令文本。

使用 CommandText 属性设置或返回指定资源（如文件或目录）的相对 URL。 资源相对于由绝对 URL 显式指定的位置，或由打开的 Connection 对象隐式指定的位置。

注意

使用 http 方案的 URL 将自动调用用于 Internet 发布的 Microsoft OLE DB 提供程序。 有关详细信息，请参阅绝对 URL 和相对 URL。

应用于

命令对象 (ADO)

另请参阅

ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性示例 (VB)
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性示例 (VC++)
Requery 方法
ActiveConnection、CommandText、CommandTimeout、CommandType、Size 和 Direction 属性示例 (JScript)