OleDbCommand.ExecuteReader Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
- 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
member this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader
Public Function ExecuteReader () As OleDbDataReader
Restituisce
Oggetto OleDbDataReader.
Eccezioni
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
Si applica a
ExecuteReader(CommandBehavior)
- Origine:
- OleDbCommand.cs
- 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
member 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
Oggetto OleDbDataReader.
Eccezioni
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.