OdbcCommand Clase

Definición

Espacio de nombres:

System.Data.Odbc

Ensamblado:

System.Data.Odbc.dll

Paquete:

System.Data.Odbc v9.0.0-rc.1.24431.7

Source:

OdbcCommand.cs

Representa una instrucción SQL o un procedimiento almacenado que se ejecutarán en un origen de datos. Esta clase no se puede heredar.

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

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

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Herencia

Object

MarshalByRefObject

Component

DbCommand

OdbcCommand

Implementaciones

ICloneable

Ejemplos

En el ejemplo siguiente se usa ExecuteNonQuery.

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Comentarios

La clase OdbcCommand proporciona los métodos siguientes para ejecutar comandos en un origen de datos:

Artículo	Descripción
ExecuteReader	Ejecuta comandos que devuelven filas.
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 propiedad CommandText y reutilizar el objeto OdbcCommand. Sin embargo, debe cerrar el OdbcDataReader para poder ejecutar un comando nuevo o anterior.

Si la ejecución del comando provoca un OdbcException grave, como un nivel de gravedad de SQL Server de 20 o más, OdbcConnection puede cerrarse. Sin embargo, el usuario puede volver a abrir la conexión y continuar.

Constructores

OdbcCommand()	Inicializa una nueva instancia de la clase OdbcCommand.
OdbcCommand(String)	Inicializa una nueva instancia de la clase OdbcCommand con el texto de la consulta.
OdbcCommand(String, OdbcConnection)	Inicializa una nueva instancia de la clase OdbcCommand con el texto de la consulta y un objeto OdbcConnection.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Inicializa una nueva instancia de la clase OdbcCommand con el texto de la consulta, un objeto OdbcConnection y el 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 ejecutarán 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 propiedad CommandText.
Connection	Obtiene o establece el OdbcConnection usado por esta instancia del OdbcCommand.
Container	Obtiene el IContainer que contiene el Component. (Heredado de Component)
DbConnection	Obtiene o establece el DbConnection usado por este DbCommand. (Heredado de DbCommand)
DbParameterCollection	Obtiene la colección de objetos DbParameter. (Heredado de DbCommand)
DbTransaction	Obtiene o establece el DbTransaction en el que se ejecuta este objeto DbCommand. (Heredado de DbCommand)
DesignMode	Obtiene un valor que indica si el 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 de interfaz personalizado.
Events	Obtiene la lista de controladores de eventos que están asociados a este Component. (Heredado de Component)
Parameters	Obtiene el OdbcParameterCollection.
Site	Obtiene o establece el ISite del Component. (Heredado de Component)
Transaction	Obtiene o establece el OdbcTransaction en el que se ejecuta el OdbcCommand.
UpdatedRowSource	Obtiene o establece un valor que especifica cómo el método Update debe aplicar los resultados del comando al DataRow.

Métodos

Cancel()	Intenta cancelar la ejecución de un OdbcCommand.
CreateDbParameter()	Crea una nueva instancia de un objeto DbParameter. (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 objeto OdbcParameter.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o restablecimiento de recursos no administrados. (Heredado de DbCommand)
Dispose(Boolean)	Libera los recursos no administrados usados por el DbCommand y, opcionalmente, libera los recursos administrados. (Heredado de DbCommand)
DisposeAsync()	De forma asincrónica se dipa el objeto de comando. (Heredado de DbCommand)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
ExecuteDbDataReader(CommandBehavior)	Ejecuta el comando en su conexión, devolviendo 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 ExecuteReader() sincrónico 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 el 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 deben invalidar con una implementación adecuada. El token de cancelación puede omitirse opcionalmente. La implementación predeterminada invoca el método ExecuteNonQuery() sincrónico 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 objeto DbCommand hasta que se complete la tarea devuelta. (Heredado de DbCommand)
ExecuteReader()	Envía el CommandText al Connection y compila un OdbcDataReader.
ExecuteReader(CommandBehavior)	Envía el CommandText al Connectiony compila un OdbcDataReader mediante uno de los valores de CommandBehavior.
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. 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, devolviendo un DbDataReader que se puede usar para acceder 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, devolviendo un DbDataReader que se puede usar para acceder 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 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. Invoca ExecuteScalarAsync(CancellationToken) 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 ExecuteScalar() sincrónico 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 objeto DbCommand 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 el 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 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 la propiedad CommandTimeout al valor predeterminado.
ToString()	Devuelve un String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Disposed

Se produce cuando el componente se elimina 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, consulte Clone().
IDbCommand.Connection	Obtiene o establece el IDbConnection usado por esta instancia del IDbCommand. (Heredado de DbCommand)
IDbCommand.CreateParameter()	Crea una nueva instancia de un objeto IDbDataParameter. (Heredado de DbCommand)
IDbCommand.ExecuteReader()	Ejecuta el CommandText en el Connection y compila un IDataReader. (Heredado de DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Ejecuta el CommandText en el Connectiony compila un IDataReader mediante uno de los valores de CommandBehavior. (Heredado de DbCommand)
IDbCommand.Parameters	Obtiene el IDataParameterCollection. (Heredado de DbCommand)
IDbCommand.Transaction	Obtiene o establece el DbTransaction en el que se ejecuta este objeto DbCommand. (Heredado de DbCommand)

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.

Consulte también

• OdbcDataAdapter
• OdbcConnection
• Ejecutar un de comandos