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

Определение

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

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

public enum class CommandBehavior
[System.Flags]
public enum CommandBehavior
[<System.Flags>]
type CommandBehavior = 
Public Enum CommandBehavior
Наследование
CommandBehavior
Атрибуты

Поля

CloseConnection 32

При выполнении этой команды связанный объект Connection закрывается, когда закрывается связанный объект DataReader.

Default 0

Запрос может вернуть несколько наборов результатов. Выполнение запроса может повлиять на состояние базы данных. Поле Default не задает флаги CommandBehavior, поэтому вызов метода ExecuteReader(CommandBehavior.Default) функционально эквивалентен вызову метода ExecuteReader().

KeyInfo 4

Запрос возвращает информацию колонки и первичного ключа. Поставщик добавляет дополнительные столбцы в результирующий набор для существующего первичного ключа и столбцы меток времени.

SchemaOnly 2

Запрос возвращает только сведения о столбце. При использовании SchemaOnly поставщик данных .NET Framework для SQL Server предваряет оператор, выполняемый с параметром SET FMTONLY ON.

SequentialAccess 16

Содержит способ для DataReader для обработки строк, содержащих столбцы с большими двоичными значениями. Вместо загрузки всей строки, SequentialAccess позволяет DataReader загрузить данные как поток. Затем можно использовать метод GetBytes или метод GetChars, чтобы указать положение байта для начала операции чтения и ограниченный размер буфера для возврата данных.

SingleResult 1

Запрос возвращает один набор результатов.

SingleRow 8

Ожидается, что запрос вернет одну строку из первого набора результатов. Выполнение запроса может повлиять на состояние базы данных. Некоторые поставщики данных .NET могут, но не обязательно, использовать эту информацию для оптимизации производительности команды. При указании SingleRow с методом ExecuteReader() объекта OleDbCommand, поставщик данных .NET Framework для OLE DB выполняет привязку с помощью интерфейса IRow OLE DB, если он доступен. В обратном случае, используется интерфейс IRowset. Если оператор SQL должен вернуть только одну строку, рекомендуется указать SingleRow для повышения производительности приложения. Можно также указать SingleRow при выполнении запросов, которые должны возвращать несколько наборов результатов. В этом случае, если заданы и SQL-запрос с несколькими наборами результатом, и одна строка, возвращаемый результат будет содержать только первую строку первого набора результатов. Другие наборы результатов запроса не возвращаются.

Комментарии

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

Применяется к