OleDbCommand.CommandText 属性

获取或设置要对数据源执行的 SQL 语句或存储过程。

**命名空间:**System.Data.OleDb
**程序集:**System.Data(在 system.data.dll 中)

语法

声明
Public Overrides Property CommandText As String
用法
Dim instance As OleDbCommand
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 属性设置为 StoredProcedure 时,CommandType 属性应设置为存储过程的名称。如果存储过程名称包含任何特殊字符,则可能会要求用户使用转义符语法。当调用 Execute 方法之一时,该命令将执行此存储过程。

CommandType 设置为 TableDirect 时,CommandType 属性应设置为要访问的表的名称。如果任何命名表包含任何特殊字符,则会要求用户使用转义符语法。当您调用 Execute 方法之一时,将返回命名表的所有行和列。

如果当前连接正在执行“执行”(Execute) 或“获取”(Fetch) 操作,则不能设置 ConnectionCommandTypeCommandText 属性。

如果 CommandType 设置为 Text,OLE DB.NET 提供程序不支持将参数传递给 OleDbCommand 调用的 SQL 语句或存储过程的命名参数。在这种情况下,必须使用问号 (?) 占位符。例如:

SELECT * FROM Customers WHERE CustomerID = ?

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

有关更多信息,请参见 将存储过程用于命令

示例

下面的示例创建一个 OleDbCommand 并设置它的一些属性。

Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub
public void CreateMyOleDbCommand() 
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、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

请参见

参考

OleDbCommand 类
OleDbCommand 成员
System.Data.OleDb 命名空间

其他资源

使用命令