OleDbCommand Clase

Definición

Espacio de nombres:: System.Data.OleDb

Ensamblado:: System.Data.OleDb.dll

Ensamblado:: System.Data.dll

Paquete:: System.Data.OleDb v11.0.0-preview.2.26159.112

Source:: OleDbCommand.cs

Source:: OleDbCommand.cs

Source:: OleDbCommand.cs

Source:: OleDbCommand.cs

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 ejecutarán 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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
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, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable

type OleDbCommand = class
    inherit DbCommand
    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: Object

DbCommand
OleDbCommand

Herencia: Object

MarshalByRefObject

Component

DbCommand
OleDbCommand

Herencia: Object

MarshalByRefObject

Component
OleDbCommand

Atributos: RequiresDynamicCodeAttribute

Implementaciones: IDbCommand ICloneable IDisposable

Ejemplos

En el OleDbCommandejemplo siguiente se usa , junto OleDbDataAdapter y OleDbConnection, para seleccionar filas de una base de datos de Access. A continuación, se devuelve el relleno DataSet . El ejemplo se pasa a una cadena de conexión inicializada DataSet, una 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:

Artículo	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 SQL SET.
ExecuteNonQuery	Ejecuta comandos como instrucciones SQL INSERT, DELETE, UPDATE y SET.
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 se genera un nivel de gravedad de SQL Server irrecuperable OleDbException (por ejemplo, un nivel de gravedad de SQL Server de 20 o superior) generado por el método que ejecuta un OleDbCommand, OleDbConnectionse puede cerrar la conexión. Sin embargo, el usuario puede volver a abrir la conexión y continuar.

Constructores

Nombre	Description
OleDbCommand()	Inicializa una nueva instancia de la clase OleDbCommand.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicializa una nueva instancia de la OleDbCommand clase con el texto de la consulta, un OleDbConnectiony .Transaction
OleDbCommand(String, OleDbConnection)	Inicializa una nueva instancia de la OleDbCommand clase con el texto de la consulta y .OleDbConnection
OleDbCommand(String)	Inicializa una nueva instancia de la OleDbCommand clase con el texto de la consulta.

Propiedades

Nombre	Description
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) antes de terminar un intento de ejecutar un comando y generar un error.
CommandType	Obtiene o establece un valor que indica cómo se interpreta la CommandText propiedad.
Connection	Obtiene o establece el OleDbConnection objeto utilizado por esta instancia de .OleDbCommand
Container	Obtiene el IContainer objeto que contiene el Componentobjeto . (Heredado de Component)
DbConnection	Obtiene o establece el DbConnection objeto utilizado por este DbCommandobjeto . (Heredado de DbCommand)
DbParameterCollection	Obtiene la colección de DbParameter objetos . (Heredado de DbCommand)
DbTransaction	Obtiene o establece el objeto en el DbTransaction que se ejecuta este DbCommand objeto. (Heredado de DbCommand)
DesignMode	Obtiene un valor que indica si Component el objeto 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 que están asociados a este Componentobjeto . (Heredado de Component)
Parameters	Obtiene OleDbParameterCollection.
Site	Obtiene o establece el ISite objeto de .Component (Heredado de Component)
Transaction	Obtiene o establece el objeto en el OleDbTransaction que se ejecuta .OleDbCommand
UpdatedRowSource	Obtiene o establece cómo se aplican los resultados del comando al DataRow cuando se usa en el `Update` método de OleDbDataAdapter.

Métodos

Nombre	Description
Cancel()	Intenta cancelar la ejecución de un OleDbCommandobjeto .
Clone()	Crea un nuevo OleDbCommand objeto que es una copia de la instancia actual.
CreateDbParameter()	Crea una nueva instancia de un DbParameter objeto . (Heredado de DbCommand)
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
CreateParameter()	Crea una nueva instancia de un OleDbParameter objeto .
Dispose()	Libera todos los recursos usados por .Component (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados utilizados por Component y, opcionalmente, libera los recursos administrados. (Heredado de Component)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
ExecuteDbDataReader(CommandBehavior)	Ejecuta el comando en su conexión y devuelve un DbDataReader que se puede usar para acceder a los resultados. (Heredado de DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Los proveedores deben implementar este método para proporcionar una implementación no predeterminada para ExecuteReader sobrecargas. La implementación predeterminada invoca el método sincrónico ExecuteReader() y devuelve una tarea completada, bloqueando el subproceso que realiza la 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 a través de la propiedad Task Exception devuelta. Este método acepta un token de cancelación que se puede usar para solicitar la cancelación anticipada de la operación. Las implementaciones pueden omitir esta solicitud. (Heredado de DbCommand)
ExecuteNonQuery()	Ejecuta una instrucción SQL en y Connection 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. ExecuteNonQueryAsync(CancellationToken) Invoca con CancellationToken.None. (Heredado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Esta es la versión asincrónica de ExecuteNonQuery(). Los proveedores deben invalidar con una implementación adecuada. El token de cancelación puede omitirse opcionalmente. La implementación predeterminada invoca el método sincrónico ExecuteNonQuery() y devuelve una tarea completada, bloqueando el subproceso que realiza la 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 a través de la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del `DbCommand` objeto hasta que se complete la tarea devuelta. (Heredado de DbCommand)
ExecuteReader()	CommandText Envía a Connection y compila un OleDbDataReaderobjeto .
ExecuteReader(CommandBehavior)	CommandText Envía a Connectiony compila un OleDbDataReader objeto mediante uno de los CommandBehavior valores .
ExecuteReaderAsync()	Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Invoca con CancellationToken.None. (Heredado de DbCommand)
ExecuteReaderAsync(CancellationToken)	Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (Heredado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (Heredado de DbCommand)
ExecuteReaderAsync(CommandBehavior)	Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader que se puede usar para acceder a los resultados. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Invoca . (Heredado de DbCommand)
ExecuteScalar()	Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Se omiten columnas o filas adicionales.
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. ExecuteScalarAsync(CancellationToken) Invoca con CancellationToken.None. (Heredado de DbCommand)
ExecuteScalarAsync(CancellationToken)	Esta es la versión asincrónica de ExecuteScalar(). Los proveedores deben invalidar con una implementación adecuada. El token de cancelación puede omitirse opcionalmente. La implementación predeterminada invoca el método sincrónico ExecuteScalar() y devuelve una tarea completada, bloqueando el subproceso que realiza la 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 a través de la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del `DbCommand` objeto hasta que se complete la tarea devuelta. (Heredado de DbCommand)
GetHashCode()	Actúa como 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 un servicio proporcionado por Component o por su 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 Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
Prepare()	Crea una versión preparada (o compilada) del comando en el origen de datos.
ResetCommandTimeout()	Restablece la CommandTimeout propiedad al valor predeterminado.
ToString()	Devuelve un String objeto que contiene el nombre de Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Nombre	Description
Disposed	Se produce cuando el componente se elimina mediante una llamada al Dispose() método . (Heredado de Component)

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Para obtener una descripción de este miembro, vea Clone().
IDbCommand.Connection	Obtiene o establece el IDbConnection objeto utilizado por 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 IDbDataParameter objeto .
IDbCommand.CreateParameter()	Crea una nueva instancia de un IDbDataParameter objeto . (Heredado de DbCommand)
IDbCommand.ExecuteReader()	Para obtener una descripción de este miembro, vea ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Ejecuta en CommandText Connectiony compila mediante IDataReader uno de los CommandBehavior valores .
IDbCommand.Parameters	Obtiene IDataParameterCollection. (Heredado de DbCommand)
IDbCommand.Transaction	Obtiene o establece el objeto en el DbTransaction que se ejecuta este DbCommand objeto. (Heredado de DbCommand)

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?

Compartir a través de

OleDbCommand Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Eventos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios