OdbcCommand Clase

Definición

Espacio de nombres:

System.Data.Odbc

Ensamblado:

System.Data.Odbc.dll

Paquete:

System.Data.Odbc v8.0.0

Source:

OdbcCommand.cs

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

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

DbCommand

OdbcCommand

Implementaciones

ICloneable

Ejemplos

En el ejemplo siguiente se utiliza 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 OdbcCommand clase proporciona los métodos siguientes para ejecutar comandos en un origen de datos:

Elemento	Descripción
ExecuteReader	Ejecuta comandos que devuelven filas.
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 OdbcCommand objeto . Sin embargo, debe cerrar antes OdbcDataReader de poder ejecutar un comando nuevo o anterior.

Si la ejecución del comando provoca un error graveOdbcException, 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 Transaction.

Propiedades

CommandText	Obtiene o establece una instrucción SQL o un procedimiento almacenado que se van a ejecutar en un 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 OdbcConnection que usa esta instancia de OdbcCommand.
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)
DesignTimeVisible	Obtiene o establece un valor que indica si el objeto de comando debe estar visible en un control de interfaz personalizado.
Parameters	Obtiene la estructura OdbcParameterCollection.
Transaction	Obtiene o establece la transacción OdbcTransaction en la que se ejecuta OdbcCommand.
UpdatedRowSource	Obtiene o establece un valor que especifica cómo debe aplicar el método Update los resultados del comando en DataRow.

Métodos

Cancel()	Intenta cancelar la ejecución de OdbcCommand.
CreateDbParameter()	Crea una nueva instancia de un objeto DbParameter. (Heredado de DbCommand)
CreateParameter()	Crea una nueva instancia de un objeto OdbcParameter .
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de DbCommand)
Dispose(Boolean)	Libera los recursos no administrados que usa DbCommand y, de forma opcional, libera los recursos administrados. (Heredado de DbCommand)
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 DbCommand hasta que se haya completado la tarea devuelta. (Heredado de DbCommand)
ExecuteReader()	Envía una propiedad CommandText a la propiedad Connection y compila un objeto OdbcDataReader.
ExecuteReader(CommandBehavior)	Envía CommandText a Connection y crea un objeto OdbcDataReader 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 DbCommand hasta que se haya completado la tarea devuelta. (Heredado de DbCommand)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
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 cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

ICloneable.Clone()

Para obtener una descripción de este miembro, vea Clone().

Consulte también

• OdbcDataAdapter
• OdbcConnection
• Ejecutar un comando