SqlCeCommand 类

表示对数据源执行的 SQL 语句。

继承层次结构

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

命名空间:  System.Data.SqlServerCe
程序集:  System.Data.SqlServerCe(在 System.Data.SqlServerCe.dll 中)

语法

声明
Public NotInheritable Class SqlCeCommand _
    Inherits DbCommand _
    Implements ICloneable
用法
Dim instance As SqlCeCommand
public sealed class SqlCeCommand : DbCommand, 
    ICloneable
public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable
[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end
public final class SqlCeCommand extends DbCommand implements ICloneable

SqlCeCommand 类型公开以下成员。

构造函数

  名称 说明
公共方法 SqlCeCommand() 初始化 SqlCeCommand 类的一个新实例。
公共方法 SqlCeCommand(String) 用查询文本初始化 SqlCeCommand 类的一个新实例。
公共方法 SqlCeCommand(String, SqlCeConnection) 初始化具有查询文本和 SqlCeConnection 的 SqlCeCommand 类的一个新实例。
公共方法 SqlCeCommand(String, SqlCeConnection, SqlCeTransaction) 使用查询文本、一个 SqlCeConnection 以及 SqlCeTransaction 来初始化 SqlCeCommand 类的一个新实例。

页首

属性

  名称 说明
受保护属性 CanRaiseEvents (继承自 Component
公共属性 CommandText 获取或设置在数据源执行的 SQL 语句。 (覆盖 DbCommand.CommandText。)
公共属性 CommandTimeout 获取或设置在终止尝试执行命令和生成错误之前的等待时间。 (覆盖 DbCommand.CommandTimeout。)
公共属性 CommandType 获取或设置一个指示如何解释 CommandText 属性的值。 (覆盖 DbCommand.CommandType。)
公共属性 Connection 获取或设置 SqlCeCommand 的这个实例使用的 SqlCeConnection
公共属性 Container (继承自 Component
受保护属性 DbConnection (继承自 DbCommand
受保护属性 DbParameterCollection (继承自 DbCommand
受保护属性 DbTransaction (继承自 DbCommand
受保护属性 DesignMode (继承自 Component
公共属性 DesignTimeVisible 获取总是返回 false,而设置总是引发 NotSupportedException。 (覆盖 DbCommand.DesignTimeVisible。)
受保护属性 Events (继承自 Component
公共属性 IndexName 指定要打开的索引。
公共属性 Parameters 获取 SqlCeParameterCollection
公共属性 Site (继承自 Component
公共属性 Transaction 获取或设置执行 SqlCeCommand 的事务。
公共属性 UpdatedRowSource 获取或设置当 DbDataAdapterUpdate 方法使用命令结果时将命令结果应用于 DataRow 的方式。此属性不应与 SQL Server Compact 的 .NET Compact Framework 数据提供程序一起使用。 (覆盖 DbCommand.UpdatedRowSource。)

页首

方法

  名称 说明
公共方法 Cancel 试图取消 SqlCeCommand 的执行。 (覆盖 DbCommand.Cancel()。)
受保护方法 CreateDbParameter (继承自 DbCommand
公共方法 CreateObjRef (继承自 MarshalByRefObject
公共方法 CreateParameter 创建 SqlCeParameter 对象的一个新实例。
公共方法 Dispose() (继承自 Component
受保护方法 Dispose(Boolean) (继承自 Component
公共方法 Equals (继承自 Object
受保护方法 ExecuteDbDataReader (继承自 DbCommand
公共方法 ExecuteNonQuery 针对 SqlCeConnection 执行 SQL 语句并返回受影响的行数。 (覆盖 DbCommand.ExecuteNonQuery()。)
公共方法 ExecuteReader() CommandText 发送到 Connection 并生成一个 SqlCeDataReader
公共方法 ExecuteReader(CommandBehavior) CommandText 发送到 Connection,并使用某一 CommandBehavior 值生成 SqlCeDataReader
公共方法 ExecuteResultSet(ResultSetOptions) CommandText 发送到 Connection 并使用 ResultSetOptions 生成一个 SqlCeResultSet
公共方法 ExecuteResultSet(ResultSetOptions, SqlCeResultSet) CommandText 发送到 Connection 并使用 ResultSetOptions 生成一个 SqlCeResultSet
公共方法 ExecuteScalar 执行查询,并返回查询所返回的结果集中第一行的第一列。忽略额外的列或行。 (覆盖 DbCommand.ExecuteScalar()。)
受保护方法 Finalize (继承自 Component
公共方法 GetHashCode (继承自 Object
公共方法 GetLifetimeService (继承自 MarshalByRefObject
受保护方法 GetService (继承自 Component
公共方法 GetType (继承自 Object
公共方法 InitializeLifetimeService (继承自 MarshalByRefObject
受保护方法 MemberwiseClone() (继承自 Object
受保护方法 MemberwiseClone(Boolean) (继承自 MarshalByRefObject
公共方法 Prepare 在数据源上创建该命令的准备好的(或已编译的)版本。 (覆盖 DbCommand.Prepare()。)
公共方法 SetRange 限制 SqlCeDataReader 将读取的行集。
公共方法 ToString (继承自 Component

页首

事件

  名称 说明
公共事件 Disposed (继承自 Component

页首

显式接口实现

  名称 说明
显式接口实现私有方法 ICloneable.Clone
显式接口实现私有属性 IDbCommand.Connection (继承自 DbCommand
显式接口实现私有方法 IDbCommand.CreateParameter (继承自 DbCommand
显式接口实现私有方法 IDbCommand.ExecuteReader() (继承自 DbCommand
显式接口实现私有方法 IDbCommand.ExecuteReader(CommandBehavior) (继承自 DbCommand
显式接口实现私有属性 IDbCommand.Parameters (继承自 DbCommand
显式接口实现私有属性 IDbCommand.Transaction (继承自 DbCommand

页首

注释

当创建 SqlCeCommand 的实例时,读/写属性将被设置为它们的初始值。有关这些值的列表,请参阅 SqlCeCommand 构造函数。

SqlCeCommand 具有以下方法(这些方法在数据源执行命令):

说明

ExecuteReader

执行返回行的命令。

ExecuteNonQuery

执行诸如 INSERT、DELETE 和 UPDATE 语句之类的 SQL 命令。

ExecuteScalar

从数据库中检索单个值(例如一个聚合值)。

ExecuteResultSet

执行命令并返回结果集。

SQL Server Compact 的数据提供程序不支持批查询。命令的格式必须是:

Select * from Customers 而不能是Select * from Customers; Select * from Orders;

如果使用为 System.Data.SqlClient 生成的代码,则必须更改查询以使它们符合此限制。

SQL Server Compact 不仅支持共享同一连接的多个命令,还支持多个并发连接。这意味着可能在同一个连接上存在多个 SqlCeDataReader 实例。此行为不同于 System.Data.SqlClient 的行为。

如果执行 SqlCeCommand 的方法产生了致命的 SqlCeExceptionSqlCeConnection 可能会被关闭。您可以重新打开连接,然后继续。

示例

下面的示例使用 SqlCeCommand 以及 SqlCeConnection 从数据库选择行。

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try
string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    conn.Close();
}

线程安全

此类型的任何公共静态(在 Microsoft Visual Basic 中为共享)成员是线程安全的。不保证所有实例成员都对于线程安全的。

请参阅

参考

System.Data.SqlServerCe 命名空间

SqlCeDataAdapter

SqlCeConnection