OleDbCommand.CommandText 属性

定义

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

属性值

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 一种方法时,将返回命名表或表的所有行和列。

如果当前连接正在执行或提取操作,则无法设置ConnectionCommandTypeCommandText属性。

The OLE DB.NET Provider does not support named parameters for passing parameters to an SQL Statement or a stored procedure called by an OleDbCommand when CommandType is set to Text. 在这种情况下,必须使用问号 (?) 占位符。 例如:

SELECT * FROM Customers WHERE CustomerID = ?

因此,对象添加到OleDbParameterCollection对象的顺序OleDbParameter必须直接对应于参数的问号占位符的位置。

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

适用于

另请参阅