OleDbCommand Clase
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í.
Representa una instrucción SQL o un procedimiento almacenado que se van a ejecutar en un origen de datos.
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
type OleDbCommand = class
inherit DbCommand
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit DbCommand
interface IDbCommand
interface IDisposable
interface ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
- Herencia
- Herencia
- Implementaciones
Ejemplos
En el OleDbCommandejemplo siguiente se usa , junto OleDbDataAdapter con y OleDbConnection, para seleccionar filas de una base de datos de Access. A continuación, se devuelve el relleno DataSet . En el ejemplo se pasa un objeto inicializado DataSet, un cadena de conexión, una cadena de consulta que es una instrucción SELECT de SQL y una cadena que es el nombre de la tabla de base de datos de origen.
public void ReadMyData(string connectionString)
{
string queryString = "SELECT OrderID, CustomerID FROM Orders";
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbCommand command = new OleDbCommand(queryString, connection);
connection.Open();
OleDbDataReader reader = command.ExecuteReader();
while (reader.Read())
{
Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
}
// always call Close when done reading.
reader.Close();
}
}
Public Sub ReadMyData(ByVal connectionString As String)
Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
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.GetInt32(0).ToString() + ", " _
+ reader.GetString(1))
End While
' always call Close when done reading.
reader.Close()
End Using
End Sub
Comentarios
Cuando se crea una instancia de , las propiedades de OleDbCommand lectura y escritura se establecen en sus valores iniciales. Para obtener una lista de estos valores, consulte el OleDbCommand constructor .
OleDbCommand incluye los métodos siguientes que ejecutan comandos en un origen de datos:
Elemento | Descripción |
---|---|
ExecuteReader | Ejecuta comandos que devuelven filas. ExecuteReader es posible que no tenga el efecto que desea si se usa para ejecutar comandos como instrucciones SET de SQL. |
ExecuteNonQuery | Ejecuta comandos como instrucciones INSERT, DELETE, UPDATE y SET de SQL. |
ExecuteScalar | Recupera un valor único, por ejemplo, un valor agregado de una base de datos. |
Puede restablecer la CommandText propiedad y reutilizar el OleDbCommand objeto . Sin embargo, debe cerrar antes OleDbDataReader de poder ejecutar un comando nuevo o anterior.
Si un valor irrecuperable OleDbException (por ejemplo, un nivel de gravedad de SQL Server de 20 o superior) se genera mediante el método que ejecuta , OleDbCommandse OleDbConnectionpuede cerrar la conexión. Sin embargo, el usuario puede volver a abrir la conexión y continuar.
Constructores
OleDbCommand() |
Inicializa una nueva instancia de la clase OleDbCommand. |
OleDbCommand(String) |
Inicializa una nueva instancia de la clase OleDbCommand con el texto de la consulta. |
OleDbCommand(String, OleDbConnection) |
Inicializa una nueva instancia de la clase OleDbCommand con el texto de la consulta y una OleDbConnection. |
OleDbCommand(String, OleDbConnection, OleDbTransaction) |
Inicializa una nueva instancia de la clase OleDbCommand con el texto de la consulta, un objeto OleDbConnection y el objeto Transaction. |
Propiedades
CanRaiseEvents |
Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component) |
CommandText |
Obtiene o establece la instrucción SQL o el procedimiento almacenado que se va a ejecutar en el origen de datos. |
CommandTimeout |
Obtiene o establece el tiempo de espera (en segundos) hasta que se interrumpe un intento de ejecutar un comando y se genera un error. |
CommandType |
Obtiene o establece un valor que indica cómo se interpreta la propiedad CommandText. |
Connection |
Obtiene o establece la interfaz OleDbConnection que usa esta instancia de OleDbCommand. |
Container |
Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component) |
DbConnection |
Obtiene o establece el objeto DbConnection utilizado por este DbCommand. (Heredado de DbCommand) |
DbParameterCollection |
Obtiene la colección de objetos DbParameter. (Heredado de DbCommand) |
DbTransaction |
Obtiene o establece DbTransaction dentro del cual se ejecuta este objeto DbCommand. (Heredado de DbCommand) |
DesignMode |
Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component) |
DesignTimeVisible |
Obtiene o establece un valor que indica si el objeto de comando debe estar visible en un control personalizado del Diseñador de Windows Forms. |
Events |
Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component) |
Parameters |
Obtiene la estructura OleDbParameterCollection. |
Site |
Obtiene o establece ISite de Component. (Heredado de Component) |
Transaction |
Obtiene o establece la transacción OleDbTransaction en la que se ejecuta OleDbCommand. |
UpdatedRowSource |
Obtiene o establece la manera en que se aplican los resultados del comando a DataRow cuando lo utiliza el método |
Métodos
Cancel() |
Intenta cancelar la ejecución de OleDbCommand. |
Clone() |
Crea un nuevo objeto OleDbCommand que es una copia de la instancia actual. |
CreateDbParameter() |
Crea una nueva instancia de un objeto DbParameter. (Heredado de DbCommand) |
CreateObjRef(Type) |
Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject) |
CreateParameter() |
Crea una nueva instancia de un objeto OleDbParameter . |
Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de DbCommand) |
Dispose() |
Libera todos los recursos que usa Component. (Heredado de Component) |
Dispose(Boolean) |
Libera los recursos no administrados que usa DbCommand y, de forma opcional, libera los recursos administrados. (Heredado de DbCommand) |
Dispose(Boolean) |
Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component) |
DisposeAsync() |
Desecha de forma asincrónica el objeto de comando. (Heredado de DbCommand) |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
ExecuteDbDataReader(CommandBehavior) |
Ejecuta el comando en su conexión, devolviendo un DbDataReader objeto que se puede usar para tener acceso a los resultados. (Heredado de DbCommand) |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
Los proveedores deben implementar este método para proporcionar una implementación no predeterminada para las sobrecargas de ExecuteReader. La implementación predeterminada invoca el método sincrónico ExecuteReader() y devuelve una tarea completada, bloqueando el subproceso de llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteReader se comunicarán mediante la propiedad Task Exception devuelta. Este método acepta un token de cancelación que se puede usar para solicitar que la operación se cancele pronto. Las implementaciones pueden omitir esta solicitud. (Heredado de DbCommand) |
ExecuteNonQuery() |
Ejecuta una instrucción SQL en Connection y devuelve el número de filas afectadas. |
ExecuteNonQueryAsync() |
Una versión asincrónica de ExecuteNonQuery(), que ejecuta el comando en su objeto de conexión, devolviendo el número de filas afectadas. Invoca ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None. (Heredado de DbCommand) |
ExecuteNonQueryAsync(CancellationToken) |
Esta es la versión asincrónica de ExecuteNonQuery(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede omitir opcionalmente. La implementación predeterminada invoca el método sincrónico ExecuteNonQuery() y devuelve una tarea completada, bloqueando el subproceso de llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteNonQuery() se comunicarán mediante la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del objeto |
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. |
ExecuteReaderAsync() |
Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, que devuelve un DbDataReader objeto que se puede usar para tener acceso a los resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) con CancellationToken.None. (Heredado de DbCommand) |
ExecuteReaderAsync(CancellationToken) |
Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, que devuelve un DbDataReader objeto que se puede usar para tener acceso a los resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Heredado de DbCommand) |
ExecuteReaderAsync(CommandBehavior) |
Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, que devuelve un DbDataReader objeto que se puede usar para tener acceso a los resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Heredado de DbCommand) |
ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Heredado de DbCommand) |
ExecuteScalar() |
Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devueltos por la consulta. Las demás columnas o filas no se tienen en cuenta. |
ExecuteScalarAsync() |
Una versión asincrónica de ExecuteScalar(), que ejecuta el comando y devuelve la primera columna de la primera fila del primer conjunto de resultados devuelto. Se omiten todas las demás columnas, filas y conjuntos de resultados. Invoca ExecuteScalarAsync(CancellationToken) con CancellationToken.None. (Heredado de DbCommand) |
ExecuteScalarAsync(CancellationToken) |
Esta es la versión asincrónica de ExecuteScalar(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede omitir opcionalmente. La implementación predeterminada invoca el método sincrónico ExecuteScalar() y devuelve una tarea completada, bloqueando el subproceso de llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteScalar se comunicarán mediante la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del objeto |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetLifetimeService() |
Obsoletos.
Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
GetService(Type) |
Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
InitializeLifetimeService() |
Obsoletos.
Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
MemberwiseClone(Boolean) |
Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject) |
Prepare() |
Crea una versión preparada (o compilada) del comando en el origen de datos. |
PrepareAsync(CancellationToken) |
Crea de forma asincrónica una versión preparada (o compilada) del comando en el origen de datos. (Heredado de DbCommand) |
ResetCommandTimeout() |
Restablece el valor predeterminado de la propiedad CommandTimeout. |
ToString() |
Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component) |
Eventos
Disposed |
Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component) |
Implementaciones de interfaz explícitas
ICloneable.Clone() |
Para obtener una descripción de este miembro, vea Clone(). |
IDbCommand.Connection |
Obtiene o establece la interfaz IDbConnection que usa esta instancia de IDbCommand. (Heredado de DbCommand) |
IDbCommand.CreateParameter() |
Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Crea una nueva instancia de un objeto IDbDataParameter . |
IDbCommand.CreateParameter() |
Crea una nueva instancia de un objeto IDbDataParameter . (Heredado de DbCommand) |
IDbCommand.ExecuteReader() |
Para obtener una descripción de este miembro, vea ExecuteReader(). |
IDbCommand.ExecuteReader(CommandBehavior) |
Ejecuta CommandText contra Connection y genera IDataReader mediante uno de los valores de CommandBehavior. |
IDbCommand.Parameters |
Obtiene la estructura IDataParameterCollection. (Heredado de DbCommand) |
IDbCommand.Transaction |
Obtiene o establece DbTransaction dentro del cual se ejecuta este objeto DbCommand. (Heredado de DbCommand) |
Métodos de extensión
ConfigureAwait(IAsyncDisposable, Boolean) |
Configura la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable. |
Se aplica a
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de