OleDbCommand.ExecuteReader Metodo

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacchetto:

System.Data.OleDb v9.0.0-rc.2.24473.5

Invia CommandText a Connection e compila un oggetto OleDbDataReader.

Overload

ExecuteReader()	Invia CommandText a Connection e compila un oggetto OleDbDataReader.
ExecuteReader(CommandBehavior)	Invia la proprietà CommandText alla proprietà Connection e compila una classe OleDbDataReader mediante uno dei valori di CommandBehavior.

ExecuteReader()

Origine:

OleDbCommand.cs

Invia CommandText a Connection e compila un oggetto 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

Restituisce

OleDbDataReader

Oggetto OleDbDataReader.

Eccezioni

InvalidOperationException

Impossibile eseguire un comando all'interno di un contesto di transazione differente da quello in cui la connessione è stata in origine inserita.

Esempio

L'esempio seguente crea un oggetto OleDbCommande lo esegue passando una stringa che è un'istruzione SQL SELECT e una stringa da usare per connettersi all'origine dati.

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

Commenti

Quando la CommandType proprietà è impostata su StoredProcedure, la CommandText proprietà deve essere impostata sul nome della stored procedure. Il comando esegue questa stored procedure quando si chiama ExecuteReader.

Prima di chiudere l'oggetto OleDbConnection, chiudere prima di tutto l'oggetto OleDbDataReader . È inoltre necessario chiudere l'oggetto OleDbDataReader se si prevede di riutilizzare un OleDbCommand oggetto.

Vedi anche

• Uso dei comandi

ExecuteReader(CommandBehavior)

Origine:

OleDbCommand.cs

Invia la proprietà CommandText alla proprietà Connection e compila una classe OleDbDataReader mediante uno dei valori di 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

Parametri

behavior

CommandBehavior

Uno dei valori di CommandBehavior.

Restituisce

OleDbDataReader

Oggetto OleDbDataReader.

Eccezioni

InvalidOperationException

Impossibile eseguire un comando all'interno di un contesto di transazione differente da quello in cui la connessione è stata in origine inserita.

Esempio

Nell'esempio seguente viene creato un OleDbCommandoggetto e quindi viene eseguito passando una stringa che è un'istruzione Transact-SQL SELECT e una stringa da usare per connettersi all'origine dati. CommandBehavior è impostato su 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

Commenti

Quando si specifica SingleRow con il ExecuteReader metodo dell'oggetto, il provider di dati .NET Framework per OLE DB esegue l'associazione OleDbCommand usando l'interfaccia IRow OLE DB, se disponibile. In caso contrario, usa l'interfaccia IRowset . Se si prevede che l'istruzione SQL restituisca solo una singola riga, è possibile specificare SingleRow per migliorare le prestazioni dell'applicazione.

Quando la CommandType proprietà è impostata su StoredProcedure, la CommandText proprietà deve essere impostata sul nome della stored procedure. Il comando esegue questa stored procedure quando si chiama ExecuteReader.

OleDbDataReader Supporta una modalità speciale che consente di leggere in modo efficiente valori binari di grandi dimensioni. Per altre informazioni, vedere l'impostazione SequentialAccess per CommandBehavior.

Prima di chiudere l'oggetto OleDbConnection, chiudere prima di tutto l'oggetto OleDbDataReader . È inoltre necessario chiudere l'oggetto OleDbDataReader se si prevede di riutilizzare un OleDbCommand oggetto. Se viene OleDbDataReader creato con CommandBehavior impostato su CloseConnection, la chiusura della OleDbDataReader connessione viene chiusa automaticamente.

Vedi anche

• Uso dei comandi