CommandBehavior 列舉

定義

提供查詢結果和其對資料庫之作用的描述。

此列舉支援其成員值的位元組合。

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
繼承
CommandBehavior
屬性

欄位

CloseConnection 32

當命令執行時,相關聯的 Connection 物件會在相關聯的 DataReader 物件關閉時關閉。

Default 0

要求可能傳回多個結果集 (Result Set)。 執行查詢可能會影響資料庫狀態。 Default 設定為沒有 CommandBehavior 旗標,所以呼叫 ExecuteReader(CommandBehavior.Default) 在功能上相當於呼叫 ExecuteReader()

KeyInfo 4

查詢會傳回資料行和主索引鍵資訊。 提供者會將額外資料行附加到現有主索引鍵和時間戳記資料行的結果集中。

SchemaOnly 2

查詢只會傳回資料行資訊。 當使用 SchemaOnly 時,.NET Framework Data Provider for SQL Server 會優先於使用 SET FMTONLY ON 執行的陳述式。

SequentialAccess 16

提供方法來讓 DataReader 使用大型二進位值來處理含有資料行的資料列。 SequentialAccess 並不會載入整個資料列,而是啟用 DataReader 來載入資料做為資料流。 然後您可以使用 GetBytesGetChars 方法來指定要開始讀取作業的位元組位置和所傳回資料的限制緩衝區大小。

SingleResult 1

查詢傳回單一結果集。

SingleRow 8

查詢預期會傳回第一個結果集的單一資料列。 執行查詢可能會影響資料庫狀態。 某些 .NET 資料提供者可以使用此資訊來最佳化命令的效能,但並不一定要這樣做。 當您使用 SingleRow 物件的 ExecuteReader() 方法來指定 OleDbCommand 時,.NET Framework Data Provider for OLE DB 會使用 OLE DB IRow 介面 (如果可用) 來執行繫結。 否則,它會使用 IRowset 介面。 如果 SQL 陳述式預期只會傳回單一資料列,則指定 SingleRow 也可以增進應用程式效能。 在執行預期會傳回多個結果集的要求時,可能指定 SingleRow。 在這種情況下,也就是同時指定多結果集 SQL 查詢及單一資料列時,傳回的結果將只會包含第一個結果集中的第一個資料列, 而不會傳回查詢的其他結果集。

備註

如需此 API 的詳細資訊,請參閱 CommandBehavior 的補充 API 備註

適用於