通过

CommandBehavior 枚举

  • 项目

提供对查询结果和查询对数据库的影响的说明。

此枚举有一个 FlagsAttribute 属性，允许其成员值按位组合。

**命名空间:**System.Data
**程序集:**System.Data（在 system.data.dll 中）

语法

声明
<FlagsAttribute> _
Public Enumeration CommandBehavior
用法
Dim instance As CommandBehavior

[FlagsAttribute] 
public enum CommandBehavior

[FlagsAttribute] 
public enum class CommandBehavior

/** @attribute FlagsAttribute() */ 
public enum CommandBehavior

FlagsAttribute 
public enum CommandBehavior

成员

  成员名称 说明
由 .NET Compact Framework 支持 CloseConnection 在执行该命令时，如果关闭关联的 DataReader 对象，则关联的 Connection 对象也将关闭。 
由 .NET Compact Framework 支持 Default 此查询可能返回多个结果集。执行查询可能会影响数据库状态。Default 不设置 CommandBehavior 标志，因此调用 ExecuteReader(CommandBehavior.Default) 在功能上等效于调用 ExecuteReader()。 
由 .NET Compact Framework 支持 KeyInfo 此查询返回列和主键信息。  

当 KeyInfo 用于命令执行时，提供程序将为现有主键列和时间戳列的结果集附加额外的列。

当使用 KeyInfo 时，用于 SQL Server 的 .NET Framework 数据提供程序将在要执行的语句前加上 SET FMTONLY OFF 和 SET NO_BROWSETABLE ON。用户应该注意潜在的副作用，例如对 SET FMTONLY ON 语句的使用产生的干扰。有关更多信息，请参见“SQL Server 联机丛书”。
由 .NET Compact Framework 支持 SchemaOnly 查询仅返回列信息。当使用 SchemaOnly 时，用于 SQL Server 的 .NET Framework 数据提供程序将在要执行的语句前加上 SET FMTONLY ON。 
由 .NET Compact Framework 支持 SequentialAccess 提供一种方法，以便 DataReader 处理包含带有大二进制值的列的行。SequentialAccess 不是加载整行，而是使 DataReader 将数据作为流来加载。然后可以使用 GetBytes 或 GetChars 方法来指定开始读取操作的字节位置以及正在返回的数据的有限的缓冲区大小。 

当指定 SequentialAccess 时，尽管无需读取每个列，但是需要按照列的返回顺序读取它们。一旦已经读过返回的数据流中某个位置的内容，就不能再从 DataReader 中读取该位置或该位置之前的数据。当使用 OleDbDataReader 时，可重新读取当前列的值，直到读过它。当使用 SqlDataReader 时，一次只能读取一个列值。
由 .NET Compact Framework 支持 SingleResult 查询返回一个结果集。 
由 .NET Compact Framework 支持 SingleRow 查询应返回一行。执行查询可能会影响数据库的状态。一些 .NET Framework 数据提供程序可能（但不要求）使用此信息来优化命令的性能。用 OleDbCommand 对象的 ExecuteReader 方法指定 SingleRow 时，用于 OLE DB 的 .NET Framework 数据提供程序使用 OLE DB IRow 接口（如果可用）执行绑定。否则，它使用 IRowset 接口。如果您的 SQL 语句应该只返回一行，则指定 SingleRow 还可以提高应用程序性能。在执行返回多个结果集的查询时，可以指定 SingleRow。在这种情况下，仍返回多个结果集，但每个结果集只有一行。 

备注

IDbCommand 及从它派生的任何类的 ExecuteReader 方法都使用 CommandBehavior 值。

可以使用这些值的按位组合。

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、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

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

System.Data 命名空间