OleDbCommand.ExecuteReader Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Envía una propiedad CommandText a la propiedad Connection y compila un objeto OleDbDataReader.
Sobrecargas
ExecuteReader() |
Envía una propiedad CommandText a la propiedad Connection y compila un objeto OleDbDataReader. |
ExecuteReader(CommandBehavior) |
Envía CommandText a Connection y crea un objeto OleDbDataReader con uno de los valores de CommandBehavior. |
ExecuteReader()
- Source:
- OleDbCommand.cs
- Source:
- OleDbCommand.cs
Envía una propiedad CommandText a la propiedad Connection y compila un objeto 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
Devoluciones
Objeto OleDbDataReader.
Excepciones
No se puede ejecutar un comando en un contexto de transacción distinto al contexto en que se incorporó la conexión originalmente.
Ejemplos
En el ejemplo siguiente se crea un OleDbCommandy, a continuación, se ejecuta pasando una cadena que es una instrucción SELECT de SQL y una cadena que se va a usar para conectarse al origen de datos.
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
Comentarios
Cuando la CommandType propiedad se establece StoredProcedure
en , la CommandText propiedad debe establecerse en el nombre del procedimiento almacenado. El comando ejecuta este procedimiento almacenado cuando se llama a ExecuteReader.
Antes de cerrar OleDbConnection, primero cierre el OleDbDataReader objeto . También debe cerrar el OleDbDataReader objeto si planea reutilizar un OleDbCommand objeto.
Consulte también
Se aplica a
ExecuteReader(CommandBehavior)
- Source:
- OleDbCommand.cs
- Source:
- OleDbCommand.cs
Envía CommandText a Connection y crea un objeto OleDbDataReader con uno de los valores de 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
Parámetros
- behavior
- CommandBehavior
Uno de los valores de CommandBehavior.
Devoluciones
Objeto OleDbDataReader.
Excepciones
No se puede ejecutar un comando en un contexto de transacción distinto al contexto en que se incorporó la conexión originalmente.
Ejemplos
En el ejemplo siguiente se crea un OleDbCommandy, a continuación, se ejecuta pasando una cadena que es una instrucción SELECT de Transact-SQL y una cadena que se va a usar para conectarse al origen de datos. El valor de CommandBehavior está establecido en 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
Comentarios
Cuando se especifica SingleRow con el ExecuteReader método del OleDbCommand objeto , el proveedor de datos de .NET Framework para OLE DB realiza el enlace mediante la interfaz IRow de OLE DB si está disponible. De lo contrario, usa la interfaz IRowset . Además, si se espera que la instrucción SQL devuelva una única fila, se puede mejorar el rendimiento de la aplicación especificando SingleRow.
Cuando la CommandType propiedad se establece StoredProcedure
en , la CommandText propiedad debe establecerse en el nombre del procedimiento almacenado. El comando ejecuta este procedimiento almacenado cuando se llama a ExecuteReader.
OleDbDataReader admite un modo especial que permite leer valores binarios grandes de forma eficaz. Para obtener más información, vea la SequentialAccess
configuración de CommandBehavior.
Antes de cerrar OleDbConnection, primero cierre el OleDbDataReader objeto . También debe cerrar el OleDbDataReader objeto si planea reutilizar un OleDbCommand objeto.
OleDbDataReader Si se crea con establecido en CommandBehaviorCloseConnection
, al cerrar se OleDbDataReader cierra automáticamente la conexión.