OleDbCommand.ExecuteReader Metoda

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

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

CommandText Odešle na Connection a vytvoří .OleDbDataReader

Přetížení

Name	Description
ExecuteReader()	CommandText Odešle na Connection a vytvoří .OleDbDataReader
ExecuteReader(CommandBehavior)	CommandText Odešle hodnotu do objektu Connectiona vytvoří některou OleDbDataReader z CommandBehavior hodnot.

ExecuteReader()

Zdroj:

OleDbCommand.cs

CommandText Odešle na Connection a vytvoří .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

Návraty

OleDbDataReader

Objekt OleDbDataReader.

Výjimky

InvalidOperationException

Nelze spustit příkaz v kontextu transakce, který se liší od kontextu, ve kterém bylo připojení původně zařazeno.

Příklady

Následující příklad vytvoří a OleDbCommandpak ho spustí předáním řetězce, který je příkazEM SQL SELECT, a řetězcem, který se použije pro připojení ke zdroji dat.

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

Poznámky

CommandType Pokud je vlastnost nastavena na StoredProcedure, CommandText vlastnost by měla být nastavena na název uložené procedury. Příkaz spustí tuto uloženou proceduru při volání ExecuteReader.

Před zavření objektu OleDbConnectionOleDbDataReader nejprve zavřete. Objekt musíte také zavřít OleDbDataReader , pokud chcete objekt znovu použít OleDbCommand .

Viz také

• Práce s příkazy

ExecuteReader(CommandBehavior)

Zdroj:

OleDbCommand.cs

CommandText Odešle hodnotu do objektu Connectiona vytvoří některou OleDbDataReader z CommandBehavior hodnot.

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

Jedna z CommandBehavior hodnot.

Návraty

OleDbDataReader

Objekt OleDbDataReader.

Výjimky

InvalidOperationException

Nelze spustit příkaz v kontextu transakce, který se liší od kontextu, ve kterém bylo připojení původně zařazeno.

Příklady

Následující příklad vytvoří a OleDbCommandpak ho spustí předáním řetězce, který je příkazem Transact-SQL SELECT, a řetězcem, který se použije pro připojení ke zdroji dat. CommandBehavior je nastaveno na 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

Poznámky

Pokud zadáte SingleRow metodu ExecuteReader objektu OleDbCommand , zprostředkovatel dat rozhraní .NET Framework pro OLE DB provádí vazbu pomocí rozhraní OLE DB IRow , pokud je k dispozici. V opačném případě používá IRowset rozhraní. Pokud se očekává, že příkaz SQL vrátí jenom jeden řádek, může zadávání SingleRow také zlepšit výkon aplikace.

CommandType Pokud je vlastnost nastavena na StoredProcedure, CommandText vlastnost by měla být nastavena na název uložené procedury. Příkaz spustí tuto uloženou proceduru při volání ExecuteReader.

Podporuje OleDbDataReader speciální režim, který umožňuje efektivní čtení velkých binárních hodnot. Další informace naleznete v SequentialAccess nastavení pro CommandBehavior.

Před zavření objektu OleDbConnectionOleDbDataReader nejprve zavřete. Objekt musíte také zavřít OleDbDataReader , pokud chcete objekt znovu použít OleDbCommand . Pokud se vytvoří s OleDbDataReader nastaveným CommandBehavior nastavením CloseConnection, zavře OleDbDataReader připojení automaticky.

Viz také

• Práce s příkazy