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	获取或设置当 DbDataAdapter 的 Update 方法使用命令结果时将命令结果应用于 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 具有以下方法（这些方法在数据源执行命令）：

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

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

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

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

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

示例

下面的示例使用 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