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) 操作,则不能设置 Connection、CommandType 和 CommandText 属性。
如果 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 命名空间