Una vez explicado el objeto “Connectión” en un artículo anterior, .Net dispone del objeto “Command” el cual lo podremos usar para abrir una nueva conexión a una base de datos y una vez abierta podamos leer o seleccionar información, actualizar datos y / o eliminar los misma dependiendo de la propiedad o método que estemos usando.

Seguidamente os mostramos las propiedades y métodos más comunas del objeto “Command”:

• Propiedades:
  • CommandText: Indicamos la consulta que queremos realizar a nuestra base de datos.
  • CommandType: con ésta propiedad indicamos al objeto command que tipo de consulta queremos realizar, si es de texto, si es un procedimiento almacenado o si es un TableDirect, éste último únicamente nos sirve para cuando usamos base de datos Access con el proveedor OLE DB.
  • Connection: Usamos esta propiedad para conectar a nuestra base de datos, una vez configuradas las demás propiedades como “CommandText”.
  • Transaction: Con ésta propiedad podemos definir el nivel de transacción del objeto “Command”, si la queremos local definiremos en “BeginTransaction”  de SQLServer por ejemplo.
  • CommandTimeOut: Obtenemos o establecemos el tiempo de espera que queremos tener hasta que nuestra consulta espere para producir una excepción, este valor se mide en segundos y valor predeterminado es de 30 segundos. Como detalle el valor 0 significa que la espera es infinita.
  • Parameters: Obtenemos o establecemos la colección de parámetros que van asociados al objeto “Command”.
  • UpdateRowSource: Nos indica cuales son los resultados de una fila que se esté actualizando. Esta propiedad se aplica cuando usamos el objeto “DataRow” asociado a un “DataAdapter”. Hay que tener en cuenta que esta propiedad es únicamente válida para cuando actualizamos filas de una tabla. Sus valores pueden ser:
    • Both: Los datos de la primera fila se le asignan a la fila modificada del “DataSet”.
    • FirstReturnedRecord: Los datos de la primera fila retornada se asigna a la fila modificada en el “DataSet”.
    • None: No se tienen en cuentan los valores retornados.
    • OutputParameters: Los parámetros de salida se le asignan a la fila modificada del “DataSet”.
• Métodos:
  • ExecuteNonQuery: Ejecuta la acción especificada en la propiedad “CommandText” y retorna el número de filas que se encuentran afectada a la consulta.
  • ExecuteReader: Este método ejecuta la propiedad “CommandText” y retorna un objeto “DataReader”.
  • ExecuteScalar: Este método nos devuelve el valor indicado por la propiedad “CommandText” devolviéndonos el valor de la primera columna y de la primera fila y ignorando el resto de valores de la consulta de “CommandText”
  • Cancel: Con éste método podemos cancelar la ejecución del objeto “Command” no produciendo ninguna excepción si el comando no se está ejecutando.
  • CreateParameter: éste método se usa para crear una nueva instancia “Parameter” que se encuentre al objeto “Command”.
  • ResetCommandTimeOut: Realiza un reset a la propiedad CommandTimeOut”, de esta manera está propiedad vuelve a su estado original, si no hemos definido dicha propiedad anteriormente la devuelve a los 30 segundos que es el valor predeterminado de la propiedad “CommandTimeOut”.
  • ExecuteXMLReader: Este método es válido únicamente para SQL Server y podemos obtener la información en una sola fila y una sola columna en formato XML, en el caso que se devuelva más de una fila el método “ExecuteXMLReader” se asocia con “XMLReader” al resultado de la primera fila y descarta el resto de resultados.