OleDbCommand.ExecuteReader Metoda

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v8.0.0

Wysyła element CommandText do elementu Connection i tworzy element OleDbDataReader.

Przeciążenia

ExecuteReader()	Wysyła element CommandText do elementu Connection i tworzy element OleDbDataReader.
ExecuteReader(CommandBehavior)	Wysyła element CommandText do elementu Connectioni tworzy obiekt OleDbDataReader przy użyciu jednej z CommandBehavior wartości.

ExecuteReader()

Źródło:

OleDbCommand.cs

Wysyła element CommandText do elementu Connection i tworzy element 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

Zwraca

OleDbDataReader

Obiekt OleDbDataReader.

Wyjątki

InvalidOperationException

Nie można wykonać polecenia w kontekście transakcji, który różni się od kontekstu, w którym połączenie zostało pierwotnie wymienione.

Przykłady

Poniższy przykład tworzy obiekt OleDbCommand, a następnie wykonuje go, przekazując ciąg, który jest instrukcją SQL SELECT, oraz ciąg używany do nawiązywania połączenia ze źródłem danych.

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

Uwagi

CommandType Gdy właściwość jest ustawiona na StoredProcedurewartość , CommandText właściwość powinna być ustawiona na nazwę procedury składowanej. Polecenie wykonuje tę procedurę składowaną podczas wywoływania metody ExecuteReader.

Przed zamknięciem obiektu OleDbConnectionnajpierw zamknij OleDbDataReader obiekt . Należy również zamknąć obiekt, OleDbDataReader jeśli planujesz ponownie użyć OleDbCommand obiektu.

Zobacz też

• Praca z poleceniami

ExecuteReader(CommandBehavior)

Źródło:

OleDbCommand.cs

Wysyła element CommandText do elementu Connectioni tworzy obiekt OleDbDataReader przy użyciu jednej z CommandBehavior wartości.

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

Parametry

behavior

CommandBehavior

CommandBehavior Jedna z wartości.

Zwraca

OleDbDataReader

Obiekt OleDbDataReader.

Wyjątki

InvalidOperationException

Nie można wykonać polecenia w kontekście transakcji, który różni się od kontekstu, w którym połączenie zostało pierwotnie wymienione.

Przykłady

Poniższy przykład tworzy obiekt OleDbCommand, a następnie wykonuje go, przekazując ciąg, który jest instrukcją Transact-SQL SELECT, i ciągiem używanym do nawiązywania połączenia ze źródłem danych. CommandBehavior parametr jest ustawiony na CloseConnectionwartość .

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

Uwagi

Po określeniu SingleRowExecuteReaderOleDbCommand metody obiektu dostawca danych .NET Framework dla OLE DB wykonuje powiązanie przy użyciu interfejsu IRow OLE DB, jeśli jest dostępny. W przeciwnym razie używa interfejsu IRowset . Jeśli oczekuje się, że instrukcja SQL zwróci tylko jeden wiersz, określenie SingleRow może również zwiększyć wydajność aplikacji.

CommandType Gdy właściwość jest ustawiona na StoredProcedurewartość , CommandText właściwość powinna być ustawiona na nazwę procedury składowanej. Polecenie wykonuje tę procedurę składowaną podczas wywoływania metody ExecuteReader.

System OleDbDataReader obsługuje tryb specjalny, który umożliwia wydajne odczytywanie dużych wartości binarnych. Aby uzyskać więcej informacji, zobacz SequentialAccess ustawienie dla elementu CommandBehavior.

Przed zamknięciem obiektu OleDbConnectionnajpierw zamknij OleDbDataReader obiekt . Należy również zamknąć obiekt, OleDbDataReader jeśli planujesz ponownie użyć OleDbCommand obiektu. Jeśli element OleDbDataReader zostanie utworzony z ustawioną wartością CommandBehaviorCloseConnection, zamknięcie powoduje automatyczne zamknięcie OleDbDataReader połączenia.

Zobacz też

• Praca z poleceniami