OleDbCommand.CommandText 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置要对数据源执行的 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
属性值
要执行的 SQL 语句或存储过程。 默认值为一个空字符串。
实现
- 属性
示例
以下示例创建 并 OleDbCommand 设置其一些属性。
public void CreateMyOleDbCommand()
{
OleDbCommand command = new OleDbCommand();
command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
command.CommandTimeout = 20;
}
Public Sub CreateMyOleDbCommand()
Dim command As New OleDbCommand()
command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
command.CommandTimeout = 20
End Sub
注解
当 属性 CommandType 设置为 StoredProcedure
时, CommandType 属性应设置为存储过程的名称。 如果存储过程名称包含任何特殊字符,则用户可能需要使用转义字符语法。 调用方法之一时, Execute
命令将执行此存储过程。
当 设置为 TableDirect
时CommandType, CommandType 属性应设置为要访问的一个或多个表的名称。 如果任何命名表包含任何特殊字符,则用户可能需要使用转义字符语法。 调用其中一个 Execute
方法时,将返回一个或多个命名表的所有行和列。
如果当前连接正在执行执行或提取操作,则无法设置 Connection、 CommandType和 CommandText 属性。
当 设置为 Text
时CommandType,OLE DB.NET 提供程序不支持将参数传递给 SQL 语句或 调用的OleDbCommand存储过程的命名参数。 在这种情况下,必须使用问号 ( ) 占位符。 例如:
SELECT * FROM Customers WHERE CustomerID = ?
因此, OleDbParameter 将 对象添加到 OleDbParameterCollection 的顺序必须与 参数的问号占位符的位置直接对应。
有关详细信息,请参阅 配置参数和参数数据类型。