CommandBehavior Перечисление

Определение

Пространство имен:

System.Data

Сборка:

System.Data.dll

Содержит описание результатов запроса и его влияние на базу данных.

Это перечисление поддерживает побитовую комбинацию значений его членов.

public enum class CommandBehavior

[System.Flags]
public enum CommandBehavior

[<System.Flags>]
type CommandBehavior = 

Public Enum CommandBehavior

Наследование

Object

ValueType

Enum

CommandBehavior

Атрибуты

FlagsAttribute

Поля

Имя	Значение	Описание
Default	0	Запрос может возвращать несколько результирующих наборов. Выполнение запроса может повлиять на состояние базы данных. Default CommandBehavior не задает флаги, поэтому вызов ExecuteReader(CommandBehavior.Default) функционально эквивалентен вызовуExecuteReader().
SingleResult	1	Запрос возвращает один результирующий набор.
SchemaOnly	2	Запрос возвращает только сведения о столбце. При использовании SchemaOnly .NET Framework Data Provider для SQL Server предшествует выполнению инструкции с параметром SET FMTONLY ON.
KeyInfo	4	Запрос возвращает сведения о столбце и первичном ключе. Поставщик добавляет дополнительные столбцы к результирующему набору для существующих столбцов первичного ключа и метки времени.
SingleRow	8	Ожидается, что запрос возвращает одну строку первого результирующий набор. Выполнение запроса может повлиять на состояние базы данных. Некоторые .NET поставщики данных могут, но не требуются, используйте эти сведения для оптимизации производительности команды. При указании SingleRow с помощью метода ExecuteReader() объекта OleDbCommand платформа .NET Data Provider Framework для OLE DB выполняет привязку с помощью интерфейса OLE DB IRow, если он доступен. В противном случае он использует IRowset интерфейс. Если инструкция SQL, как ожидается, возвращает только одну строку, указание SingleRow также может повысить производительность приложения. При выполнении запросов, которые, как ожидается, возвращают несколько результирующих наборов, можно указать SingleRow . В этом случае при указании SQL-запроса с несколькими результирующих наборами и одной строкой результат будет содержать только первую строку первого результирующий набора. Другие результирующие наборы запроса не будут возвращены.
SequentialAccess	16	Предоставляет способ DataReader обработки строк, содержащих столбцы с большими двоичными значениями. Вместо загрузки всей строки SequentialAccess позволяет DataReader загружать данные в виде потока. Затем можно использовать GetBytes метод или GetChars метод, чтобы указать расположение байтов для запуска операции чтения, а также ограниченный размер буфера для возвращаемых данных.
CloseConnection	32	При выполнении команды связанный Connection объект закрывается при закрытии связанного DataReader объекта.

Комментарии

Дополнительные сведения об этом API см. в дополнительных примечаниях API для CommandBehavior.