OdbcCommand.ExecuteReader Метод

Определение

Отправляет свойство CommandText свойству Connection и создает объект OdbcDataReader.Sends the CommandText to the Connection and builds an OdbcDataReader.

Перегрузки

ExecuteReader()

Отправляет свойство CommandText свойству Connection и создает объект OdbcDataReader.Sends the CommandText to the Connection and builds an OdbcDataReader.

ExecuteReader(CommandBehavior)

Отправляет CommandText в Connection и создает OdbcDataReader, используя одно из значений CommandBehavior.Sends the CommandText to the Connection, and builds an OdbcDataReader using one of the CommandBehavior values.

ExecuteReader()

Отправляет свойство CommandText свойству Connection и создает объект OdbcDataReader.Sends the CommandText to the Connection and builds an OdbcDataReader.

public:
 System::Data::Odbc::OdbcDataReader ^ ExecuteReader();
public System.Data.Odbc.OdbcDataReader ExecuteReader ();
member this.ExecuteReader : unit -> System.Data.Odbc.OdbcDataReader
Public Function ExecuteReader () As OdbcDataReader

Возвращаемое значение

Объект OdbcDataReader.An OdbcDataReader object.

Комментарии

Свойству CommandText следует присвоить полный синтаксис ODBC CALL для хранимых процедур.You should set the CommandText property to the full ODBC call syntax for stored procedures. Команда выполняет эту хранимую процедуру при вызове ExecuteReader.The command executes this stored procedure when you call ExecuteReader.

При использовании OdbcDataReader связанная OdbcConnection занята обслуживанием OdbcDataReader.While the OdbcDataReader is used, the associated OdbcConnection is busy serving the OdbcDataReader. В этом состоянии другие операции с OdbcConnection, кроме закрытия, не могут быть выполнены.While in this state, no other operations can be performed on the OdbcConnection other than closing it. Это происходит до тех пор, пока не будет вызван метод Close OdbcDataReader.This is the case until the Close method of the OdbcDataReader is called.

Дополнительно

ExecuteReader(CommandBehavior)

Отправляет CommandText в Connection и создает OdbcDataReader, используя одно из значений CommandBehavior.Sends the CommandText to the Connection, and builds an OdbcDataReader using one of the CommandBehavior values.

public:
 System::Data::Odbc::OdbcDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);
public System.Data.Odbc.OdbcDataReader ExecuteReader (System.Data.CommandBehavior behavior);
member this.ExecuteReader : System.Data.CommandBehavior -> System.Data.Odbc.OdbcDataReader
Public Function ExecuteReader (behavior As CommandBehavior) As OdbcDataReader

Параметры

behavior
CommandBehavior

Одно из значений System.Data.CommandBehavior.One of the System.Data.CommandBehavior values.

Возвращаемое значение

Объект OdbcDataReader.An OdbcDataReader object.

Комментарии

Если вы хотите, чтобы инструкция SQL возвращала только одну строку, задавая SingleRow как значение CommandBehavior может повысить производительность приложения.If you expect your SQL statement to return only a single row, specifying SingleRow as the CommandBehavior value may improve application performance.

Свойству CommandText следует присвоить полный синтаксис ODBC CALL для хранимых процедур.You should set the CommandText property to the full ODBC call syntax for stored procedures. Команда выполняет эту хранимую процедуру при вызове ExecuteReader.The command executes this stored procedure when you call ExecuteReader.

OdbcDataReader поддерживает Специальный режим, позволяющий эффективно считывать большие двоичные значения.The OdbcDataReader supports a special mode that enables large binary values to be read efficiently. Дополнительные сведения см. в описании параметра SequentialAccess для CommandBehavior.For more information, see the SequentialAccess setting for CommandBehavior.

Примечание

SequentialAccess значение CommandBehavior не является ограничивающим параметром. Это просто означает, что у вас будет по крайней мере последовательный доступ к OdbcDataReader.The SequentialAccess value of CommandBehavior is not a limiting setting; it just means that you will have at least sequential access to the OdbcDataReader. Например, при использовании драйвера SQL Server ODBC в режиме SequentialAccess можно по-прежнему перейти к первому столбцу OdbcDataReader строки после последовательного считывания всех остальных столбцов.For example, when you use the SQL Server ODBC Driver in SequentialAccess mode, you can still move to the first column of an OdbcDataReader row after having read through all the other columns sequentially.

При использовании OdbcDataReader связанная OdbcConnection занята обслуживанием OdbcDataReader.While the OdbcDataReader is used, the associated OdbcConnection is busy serving the OdbcDataReader. В этом состоянии другие операции с OdbcConnection, кроме закрытия, не могут быть выполнены.While in this state, no other operations can be performed on the OdbcConnection other than closing it. Это происходит до тех пор, пока не будет вызван метод OdbcDataReader.Close.This is the case until you call the OdbcDataReader.Close method. Если OdbcDataReader создается с CommandBehavior установлен в значение CloseConnection, закрытие OdbcDataReader автоматически закрывает подключение.If the OdbcDataReader is created with CommandBehavior set to CloseConnection, closing the OdbcDataReader closes the connection automatically.

Дополнительно

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