OdbcCommand.ExecuteReader Método

Definición

Envía una propiedad CommandText a la propiedad Connection y compila un objeto OdbcDataReader.Sends the CommandText to the Connection and builds an OdbcDataReader.

Sobrecargas

ExecuteReader()

Envía una propiedad CommandText a la propiedad Connection y compila un objeto OdbcDataReader.Sends the CommandText to the Connection and builds an OdbcDataReader.

ExecuteReader(CommandBehavior)

Envía CommandText a Connection y crea un objeto OdbcDataReader con uno de los valores de CommandBehavior.Sends the CommandText to the Connection, and builds an OdbcDataReader using one of the CommandBehavior values.

ExecuteReader()

Envía una propiedad CommandText a la propiedad Connection y compila un objeto OdbcDataReader.Sends the CommandText to the Connection and builds an OdbcDataReader.

public:
 System::Data::Odbc::OdbcDataReader ^ ExecuteReader();
public System.Data.Odbc.OdbcDataReader ExecuteReader ();
override this.ExecuteReader : unit -> System.Data.Odbc.OdbcDataReader
member this.ExecuteReader : unit -> System.Data.Odbc.OdbcDataReader
Public Function ExecuteReader () As OdbcDataReader

Devoluciones

OdbcDataReader

Un objeto OdbcDataReader.An OdbcDataReader object.

Comentarios

Debe establecer la CommandText propiedad en la sintaxis de llamada ODBC completa para los procedimientos almacenados.You should set the CommandText property to the full ODBC call syntax for stored procedures. El comando ejecuta este procedimiento almacenado cuando se llama a ExecuteReader .The command executes this stored procedure when you call ExecuteReader.

Mientras OdbcDataReader se usa, el asociado OdbcConnection está ocupado atendiendo a OdbcDataReader .While the OdbcDataReader is used, the associated OdbcConnection is busy serving the OdbcDataReader. Mientras se está en este estado, no se puede realizar ninguna otra operación en OdbcConnection otra que no sea cerrarla.While in this state, no other operations can be performed on the OdbcConnection other than closing it. Este es el caso hasta que Close se llama al método de OdbcDataReader .This is the case until the Close method of the OdbcDataReader is called.

Se aplica a

ExecuteReader(CommandBehavior)

Envía CommandText a Connection y crea un objeto OdbcDataReader con uno de los valores de CommandBehavior.Sends the CommandText to the Connection, and builds an OdbcDataReader using one of the CommandBehavior values.

public:
 System::Data::Odbc::OdbcDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);
public System.Data.Odbc.OdbcDataReader ExecuteReader (System.Data.CommandBehavior behavior);
override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.Odbc.OdbcDataReader
member this.ExecuteReader : System.Data.CommandBehavior -> System.Data.Odbc.OdbcDataReader
Public Function ExecuteReader (behavior As CommandBehavior) As OdbcDataReader

Parámetros

behavior
CommandBehavior

Uno de los valores de System.Data.CommandBehavior.One of the System.Data.CommandBehavior values.

Devoluciones

OdbcDataReader

Un objeto OdbcDataReader.An OdbcDataReader object.

Comentarios

Si espera que la instrucción SQL devuelva una sola fila, especificar SingleRow como CommandBehavior valor puede mejorar el rendimiento de la aplicación.If you expect your SQL statement to return only a single row, specifying SingleRow as the CommandBehavior value may improve application performance.

Debe establecer la CommandText propiedad en la sintaxis de llamada ODBC completa para los procedimientos almacenados.You should set the CommandText property to the full ODBC call syntax for stored procedures. El comando ejecuta este procedimiento almacenado cuando se llama a ExecuteReader .The command executes this stored procedure when you call ExecuteReader.

OdbcDataReaderAdmite un modo especial que permite leer de forma eficaz valores binarios grandes.The OdbcDataReader supports a special mode that enables large binary values to be read efficiently. Para obtener más información, vea la SequentialAccess configuración de CommandBehavior .For more information, see the SequentialAccess setting for CommandBehavior.

Nota

El SequentialAccess valor de CommandBehavior no es una configuración de limitación; simplemente significa que tendrá al menos acceso secuencial a OdbcDataReader .The SequentialAccess value of CommandBehavior is not a limiting setting; it just means that you will have at least sequential access to the OdbcDataReader. Por ejemplo, cuando se usa el controlador ODBC de SQL Server en el SequentialAccess modo, todavía se puede desplazar a la primera columna de una OdbcDataReader fila después de haber leído todas las demás columnas de forma secuencial.For example, when you use the SQL Server ODBC Driver in SequentialAccess mode, you can still move to the first column of an OdbcDataReader row after having read through all the other columns sequentially.

Mientras OdbcDataReader se usa, el asociado OdbcConnection está ocupado atendiendo a OdbcDataReader .While the OdbcDataReader is used, the associated OdbcConnection is busy serving the OdbcDataReader. Mientras se está en este estado, no se puede realizar ninguna otra operación en OdbcConnection otra que no sea cerrarla.While in this state, no other operations can be performed on the OdbcConnection other than closing it. Este es el caso hasta que se llama al OdbcDataReader.Close método.This is the case until you call the OdbcDataReader.Close method. Si OdbcDataReader se crea con CommandBehavior establecido en CloseConnection , al cerrar se OdbcDataReader cierra automáticamente la conexión.If the OdbcDataReader is created with CommandBehavior set to CloseConnection, closing the OdbcDataReader closes the connection automatically.

Se aplica a