OscarCommand¶

定义¶

Namespace: System.Data.OscarClient

表示要对神通数据库执行的 SQL 语句或存储过程,不能继承此类.

public sealed class OscarCommand : DbCommand, ICloneable

构造函数¶

构造 OscarCommand 对象的实例

public OscarCommand();

// 参数: cmdText-> 执行的 SQL 语句或存储过程字符串.
public OscarCommand(string cmdText);

// 参数: cmdText -> 执行的 SQL 语句或存储过程字符串.
// 参数: connection -> 连接实例 OscarConnection.
public OscarCommand(string cmdText, OscarConnection connection);

// 参数: cmdText -> 执行的 SQL 语句或存储过程字符串.
// 参数: connection -> 连接实例 OscarConnection.
// 参数: transaction -> 事务实例 OscarTransaction.
public OscarCommand(string cmdText, OscarConnection connection, OscarTransaction transaction);

属性¶

// 获取或者设置每一次网络请求获取的最大结果集数量.
public int FetchSize { get; set; }

// 获取或设置对数据源运行的文本命令,如果将设置 CommandType 为 StoredProcedure ，则应将属性设置 CommandText 为存储过程的名称。 当调用其中一种方法时，该命令将执行此存储过程 Execute.
public string CommandText { get; set; }

// 获取或设置在终止尝试执行命令并生成错误之前的等待时间（以秒为单位）
public int CommandTimeout { get; set; }

// 获取或设置 CommandText 属性的解释方式,默认值为 Text
public CommandType CommandType { get; set; }

// 获取最后一次执行插入的影响行 ROWID.
public long LastInsertedOID { get; }

// 储存 SQL 语句或存储过程的参数
public OscarParameterCollection Parameters { get; }

// 获取或设置将在其中执行此 DbCommand 对象的 OscarTransaction.
public OscarTransaction Transaction { get; set; }

// 获取或设置命令结果在由 DataRow 的 Update 方法使用时如何应用于 DbDataAdapter,指示如何应用命令结果.除非自动生成该命令，否则默认值为 Both, 如果自动生成该命令，默认值为 None.
public UpdateRowSource UpdatedRowSource { get; set; }

// 获取或设置一个值，该值指示此命令对象在自定义界面控件中是否可见.如果该命令对象应在控件中可见，则为 true；否则为 false. 默认值为 true.
public bool DesignTimeVisible { get; set; }

// 获取或设置此 OscarCommand 使用的 OscarConnection.
public OscarConnection Connection { get; set; }

// 获取或设置参数绑定集合数量
public int ArrayBindCount { get; set; }

// 获取或设置集群主从转发规则,当为 true 则转发到备节点.
public bool DirectToSlaveSql { get; set; }

// 获取或设置集群主从转发规则,当为 true 则转发到主节点.
public bool DirectToMainSql { get; set; }

// 获取或设置此 DbCommand 使用的 DbConnection.
protected DbConnection DbConnection { get; set; }

// 获取 DbParameter 对象的集合
protected DbParameterCollection DbParameterCollection { get; }

// 获取或设置执行 DbCommand 对象时所在的 DbTransaction
protected DbTransaction DbTransaction { get; set; }

方法¶

// 尝试取消 OscarCommand 的执行
public void Cancel();

// 创建 OscarParameter 对象的新实例
public OscarParameter CreateParameter();

// 针对连接对象执行 SQL 语句
// 返回: 受影响的行数
// 注释: 您可以使用 ExecuteNonQuery 执行目录操作 (例如，查询数据库的结构或创建) 的表等数据库对象，或通过执行 UPDATE、INSERT 或 DELETE 语句来更改数据库中的数据。尽管不 ExecuteNonQuery 会返回任何行，但映射到参数的任何输出参数或返回值都将用数据填充。对于 UPDATE、INSERT 和 DELETE 语句，返回值为该命令所影响的行数。 对于其他所有类型的语句，返回值为 -1
public int ExecuteNonQuery();

// 针对连接对象执行 SQL 语句
// 参数: cmdtext -> 执行的 SQL 语句或存储过程字符串
// 返回: 受影响的行数
// 注释: 您可以使用 ExecuteNonQuery 执行目录操作 (例如，查询数据库的结构或创建) 的表等数据库对象，或通过执行 UPDATE、INSERT 或 DELETE 语句来更改数据库中的数据。尽管不 ExecuteNonQuery 会返回任何行，但映射到参数的任何输出参数或返回值都将用数据填充。对于 UPDATE、INSERT 和 DELETE 语句，返回值为该命令所影响的行数。 对于其他所有类型的语句，返回值为 -1
public int ExecuteNonQuery(string cmdtext);

// 针对 CommandText 执行并返回 OscarDataReader
public OscarDataReader ExecuteReader();

// 针对 CommandText 执行并返回 OscarDataReader
// 参数: behavior -> 用于指定命令行为的枚举值之一,提供查询结果及其对数据库的影响的说明.
public OscarDataReader ExecuteReader(CommandBehavior cb);

// 执行查询，并将查询返回的结果集中第一行的第一列返回,所有其他的列和行将被忽略.
// 返回: 结果集中第一行的第一列
public object ExecuteScalar();

// 在数据源上创建准备就绪（或已编译）的命令版本
// 注释: 如果 CommandType 属性设置为,则 TableDirect Prepare 不执行任何操作. 如果 CommandType 设置为 StoredProcedure,则对的调用 Prepare 应会成功,但这可能会导致无操作.
public void Prepare();

继承¶

继承于 DbCommand, ICloneable