OleDbCommand.ExecuteReader Метод

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v11.0.0-preview.2.26159.112

Отправляет объект CommandText в Connection и создает объект OleDbDataReader.

Перегрузки

Имя	Описание
ExecuteReader()	Отправляет объект CommandText в Connection и создает объект OleDbDataReader.
ExecuteReader(CommandBehavior)	Отправляет объект в CommandText и Connectionсоздает OleDbDataReader одно из CommandBehavior значений.

ExecuteReader()

Исходный код:

OleDbCommand.cs

Отправляет объект CommandText в Connection и создает объект OleDbDataReader.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();

public System.Data.OleDb.OleDbDataReader ExecuteReader();

override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader () As OleDbDataReader

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

OleDbDataReader

Объект OleDbDataReader.

Исключения

InvalidOperationException

Не удается выполнить команду в контексте транзакции, который отличается от контекста, в котором изначально было заказано подключение.

Примеры

В следующем примере создается объект OleDbCommand, а затем выполняется путем передачи строки, которая является инструкцией SQL SELECT, и строкой для подключения к источнику данных.

public void CreateReader(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}

Public Sub CreateReader(ByVal connectionString As String, _
    ByVal queryString As String)

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Комментарии

CommandType Если для свойства задано StoredProcedureзначение, CommandText свойство должно иметь имя хранимой процедуры. Команда выполняет эту хранимую процедуру при вызове ExecuteReader.

Перед закрытием OleDbConnectionOleDbDataReader объекта сначала закройте объект. Если планируется повторно использовать OleDbCommand объект, необходимо также закрыть OleDbDataReader объект.

См. также раздел

• Работа с командами

ExecuteReader(CommandBehavior)

Исходный код:

OleDbCommand.cs

Отправляет объект в CommandText и Connectionсоздает OleDbDataReader одно из CommandBehavior значений.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.OleDb.OleDbDataReader ExecuteReader(System.Data.CommandBehavior behavior);

override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

Параметры

behavior

CommandBehavior

Одно из значений CommandBehavior .

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

OleDbDataReader

Объект OleDbDataReader.

Исключения

InvalidOperationException

Не удается выполнить команду в контексте транзакции, который отличается от контекста, в котором изначально было заказано подключение.

Примеры

В следующем примере создается объект OleDbCommand, а затем выполняется путем передачи строки, которая является оператором Transact-SQL SELECT, и строкой для подключения к источнику данных. CommandBehavior задан как CloseConnection.

public void CreateMyOleDbDataReader(string queryString,string connectionString)
{
   OleDbConnection connection = new OleDbConnection(connectionString);
   OleDbCommand command = new OleDbCommand(queryString, connection);
   connection.Open();
   OleDbDataReader reader = command.ExecuteReader(CommandBehavior.CloseConnection);
   while(reader.Read())
   {
      Console.WriteLine(reader.GetString(0));
   }
   reader.Close();
   //Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
}

Public Sub CreateMyOleDbDataReader(queryString As String, _
    connectionString As String)
    Dim connection As New OleDbConnection(connectionString)
    Dim command As New OleDbCommand(queryString, connection)
    connection.Open()
    Dim reader As OleDbDataReader = command.ExecuteReader(CommandBehavior.CloseConnection)
    While reader.Read()
        Console.WriteLine(reader.GetString(0))
    End While
    reader.Close()
    'Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
 End Sub

Комментарии

При указании SingleRow метода ExecuteReaderOleDbCommand объекта поставщик данных .NET Framework для OLE DB выполняет привязку с помощью интерфейса OLE DB IRow , если он доступен. В противном случае он использует интерфейс IRowset . Если инструкция SQL, как ожидается, возвращает только одну строку, указание SingleRow также может повысить производительность приложения.

CommandType Если для свойства задано StoredProcedureзначение, CommandText свойство должно иметь имя хранимой процедуры. Команда выполняет эту хранимую процедуру при вызове ExecuteReader.

Поддерживает OleDbDataReader специальный режим, позволяющий эффективно читать большие двоичные значения. Дополнительные сведения см. в параметре SequentialAccessCommandBehavior.

Перед закрытием OleDbConnectionOleDbDataReader объекта сначала закройте объект. Если планируется повторно использовать OleDbCommand объект, необходимо также закрыть OleDbDataReader объект. OleDbDataReader Если он создан с CommandBehavior заданным значениемCloseConnection, закрытие OleDbDataReader соединения закрывается автоматически.

См. также раздел

• Работа с командами