El documento describe el uso de la clase SqlCommand en la ejecución de sentencias SQL en una base de datos, incluyendo sus propiedades, métodos y su configuración para manejar comandos de manera asíncrona. Detalla cómo inicializar y utilizar SqlCommand para ejecutar instrucciones como select, insert, update o delete, así como diferentes configuraciones y comportamientos de ejecución. Se incluyes ejemplos de uso y los efectos de cada método relacionado con la ejecución de comandos SQL.

2. Un SqlCommand se utiliza cuando necesitas ejecutar un tipo de
sentencia Sql a la base de datos (los tipos pueden ser: Delete,
Update, Insert o Select).
Cuando se crea una instancia de SqlCommand, las propiedades
de lectura y escritura se establecen en sus valores iniciales.
Para obtener una lista de esos valores, vea el constructor
SqlCommand.
DEFINICIÓN

3. PROPIEDADES
NOMBRE DESCRIPCIÓN
ColumnEncryptionSetting
Obtiene o establece la configuración del cifrado de columnas para este
comando.
CommandText
Obtiene o establece la instrucción de Transact-SQL, el nombre de tabla o
el procedimiento almacenado que se ejecutan en el origen de datos.
(Invalida DbCommand.CommandText).
CommandTimeout
Obtiene o establece el tiempo de espera antes de terminar el intento de
ejecutar un comando y generar un error.
(Invalida DbCommand.CommandTimeout).

4. CommandType
Obtiene o establece un valor que indica cómo se interpreta la
propiedad CommandText. (Invalida DbCommand.CommandType).
Connection
Obtiene o establece la interfaz SqlConnection que usa esta instancia
de SqlCommand.
Container Obtiene IContainer que contiene Component. (Heredado de Component).
DesignTimeVisible
Obtiene o establece un valor que indica si el objeto de comando debe estar
visible en un control del Diseñador de Windows Forms.
(Invalida DbCommand.DesignTimeVisible).
Notification
Obtiene o establece un valor que especifica el
objeto SqlNotificationRequest enlazado a este comando.

5. NotificationAutoEnlist
Obtiene o establece un valor que indica si la aplicación debe recibir
automáticamente notificaciones de consulta de un
objeto SqlDependency común.
Parameters Obtiene la estructura SqlParameterCollection.
Site Obtiene o establece la ISite de la Component. (Heredado de Component).
Transaction
Obtiene o establece la transacción SqlTransaction en la que se
ejecuta SqlCommand.
UpdatedRowSource
Obtiene o establece la manera en que se aplican los resultados del comando
a DataRow cuando lo utiliza el método Update de DbDataAdapter.
(Invalida DbCommand.UpdatedRowSource).

6. MÉTODOS
NOMBRE DESCRIPCIÓN
BeginExecuteNonQuery()
Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del
procedimiento almacenado que describe SqlCommand.
BeginExecuteNonQuery(AsyncCallbac
k, Object)
Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del
procedimiento almacenado que describe SqlCommand, dados un
procedimiento de devolución de llamada e información de estado.
BeginExecuteReader()
Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del
procedimiento almacenado que describe SqlCommand y recupera uno o
varios conjuntos de resultados del servidor.

7. BeginExecuteReader(AsyncCallback,
Object)
Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del
procedimiento almacenado que describe SqlCommand y recupera uno o
varios conjuntos de resultados del servidor, dados un procedimiento de
devolución de llamada e información de estado.
BeginExecuteReader(AsyncCallback,
Object, CommandBehavior)
Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del
procedimiento almacenado que describe SqlCommand, utilizando uno de los
valores de CommandBehavior y recuperando uno o varios conjuntos de
resultados del servidor, a partir del procedimiento de devolución de llamada
e información de estado dados.
BeginExecuteReader(CommandBehavi
or)
Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del
procedimiento almacenado que describe SqlCommand utilizando uno de los
valores de CommandBehavior.

8. BeginExecuteXmlReader()
Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del
procedimiento almacenado que describe SqlCommand y devuelve los
resultados como un objeto XmlReader.
BeginExecuteXmlReader(AsyncCallback
, Object)
Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del
procedimiento almacenado que describe SqlCommand y devuelve los
resultados como un objeto XmlReader a través de un procedimiento de
devolución de llamada.
Cancel()
Intenta cancelar la ejecución de
un SqlCommand.(Invalida DbCommand.Cancel()).
Clone() Crea un nuevo objeto SqlCommand que es una copia de la instancia actual.

9. CreateObjRef(Type)
Crea un objeto que contiene toda la información relevante necesaria para
generar a un proxy que se utiliza para comunicarse con un objeto
remoto.(Heredado de MarshalByRefObject).
CreateParameter() Crea una nueva instancia de un objeto SqlParameter.
Dispose() Libera todos los recursos que usa Component.(Heredado de Component).
EndExecuteNonQuery(IAsyncResult) Finaliza la ejecución asincrónica de una instrucción de Transact-SQL.
EndExecuteReader(IAsyncResult)
Finaliza la ejecución asincrónica de una instrucción de Transact-SQL y devuelve
el objetoSqlDataReader solicitado.

10. EndExecuteXmlReader(IAsyncResult)
Finaliza la ejecución asincrónica de una instrucción de Transact-SQL y devuelve
los datos solicitados como XML.
Equals(Object)
Determina si el objeto especificado es igual al objeto actual. (Heredado
de Object).
ExecuteNonQuery()
Ejecuta una instrucción de Transact-SQL en la conexión y devuelve el número
de filas afectadas. (Invalida DbCommand.ExecuteNonQuery()).
ExecuteNonQueryAsync()
Una versión asincrónica de ExecuteNonQuery, que ejecuta una instrucción SQL
en un objeto de conexión.
Invoca ExecuteNonQueryAsync con CancellationToken.None. (Heredado
de DbCommand).

11. ExecuteNonQueryAsync(CancellationT
oken)
Versión asincrónica de ExecuteNonQuery, que ejecuta una instrucción de
Transact-SQL con la conexión y devuelve el número de filas afectadas. Token
de cancelación que se puede usar para solicitar que se abandone la
operación antes de que transcurra el tiempo de espera del comando.Las
excepciones se mostrarán a través del objeto Task
devuelto.(Invalida DbCommand.ExecuteNonQueryAsync(CancellationToken)).
ExecuteReader()
Envía la propiedad CommandText a Connection y crea un
objeto SqlDataReader.
ExecuteReader(CommandBehavior)
Envía CommandText a Connection y crea un SqlDataReader mediante uno de
los valores deCommandBehavior.

12. ExecuteReaderAsync()
Una versión asincrónica de ExecuteReader, que envía la
propiedad CommandText a la propiedad Connection y
compila SqlDataReader. Las excepciones se mostrarán a través del
objeto Task devuelto.
ExecuteReaderAsync(CancellationToken)
Una versión asincrónica de ExecuteReader, que envía la
propiedad CommandText a la propiedadConnection y
compila SqlDataReader.
Token de cancelación que se puede usar para solicitar que se
abandone la operación antes de que transcurra el tiempo de espera
del comando. Las excepciones se mostrarán a través del objeto Task
devuelto.
ExecuteReaderAsync(CommandBehavio
r)
Versión asincrónica de ExecuteReader, que envía la
propiedad CommandText a la propiedad Connection y
compila SqlDataReader. Las excepciones se mostrarán a través del
objeto Task devuelto.

13. ExecuteReaderAsync(CommandBehavio
r, CancellationToken)
Versión asincrónica de ExecuteReader, que envía la
propiedad CommandText a la propiedad Connection y
compila SqlDataReader
Token de cancelación que se puede usar para solicitar que se
abandone la operación antes de que transcurra el tiempo de espera
del comando. Las excepciones se mostrarán a través del objeto Task
devuelto.
ExecuteScalar()
Ejecuta la consulta y devuelve la primera columna de la primera fila
del conjunto de resultados devuelto por la consulta. Las demás
columnas o filas no se tienen en cuenta.
(Invalida DbCommand.ExecuteScalar()).
ExecuteScalarAsync()
Una versión asincrónica de ExecuteScalar, que ejecuta la consulta y
devuelve la primera columna de la primera fila del conjunto de
resultados devuelto por la consulta. Se omiten todas las demás
columnas y filas.
Invoca ExecuteScalarAsync con CancellationToken.None. (Heredado
de DbCommand).

14. ExecuteScalarAsync(CancellationToken)
Versión asincrónica de ExecuteScalar que ejecuta la consulta
asincrónicamente y devuelve la primera columna de la primera fila
del conjunto de resultados que devuelve la consulta. Las demás
columnas o filas no se tienen en cuenta.
Token de cancelación que se puede usar para solicitar que se
abandone la operación antes de que transcurra el tiempo de espera
del comando. Las excepciones se mostrarán a través del objeto Task
devuelto.
(Invalida DbCommand.ExecuteScalarAsync(CancellationToken)).
ExecuteXmlReader() Envía CommandText a Connection y crea un objeto XmlReader.
ExecuteXmlReaderAsync()
Una versión asincrónica de ExecuteXmlReader, que envía la
propiedad CommandText a la propiedad Connection y compila un
objeto XmlReader.
Las excepciones se mostrarán a través del objeto Task devuelto.

15. ExecuteXmlReaderAsync(CancellationTo
ken)
Una versión asincrónica de ExecuteXmlReader, que envía la
propiedad CommandText a la propiedad Connection y compila un
objeto XmlReader.
Token de cancelación que se puede usar para solicitar que se
abandone la operación antes de que transcurra el tiempo de espera
del comando. Las excepciones se mostrarán a través del objeto Task
devuelto.
GetHashCode() Sirve como la función hash predeterminada. (Heredado de Object).
GetLifetimeService()
Recupera el objeto de servicio de duración actual que controla la
directiva de duración de esta instancia. (Heredado
de MarshalByRefObject).

16. GetType() Obtiene el Type de la instancia actual. (Heredado de Object).
InitializeLifetimeService()
Obtiene un objeto de servicio de duración para controlar la directiva de
duración de esta instancia. (Heredado de MarshalByRefObject).
Prepare()
Crea una versión preparada del comando en una instancia de SQL Server.
(Invalida DbCommand.Prepare()).
ResetCommandTimeout() Restablece el valor predeterminado de la propiedad CommandTimeout.
ToString()
Devuelve un String que contiene el nombre de la Component, si existe. Este
método no se debe invalidar. (Heredado de Component).

17. EJEMPLO
public List Listar() {
SqlConnection con = new SqlConnection(cadenaConexion);
SqlCommand com = new SqlCommand("LISTAR_CAMPANAS", con);
com.CommandType = System.Data.CommandType.StoredProcedure;
con.Open();
SqlDataReader drCampanas = com.ExecuteReader();
List listaCampanas = new List();
while (drCampanas.Read()) {
listaCampanas.Add(Cargar(drCampanas)); }
drCampanas.Close();
con.Close();
return listaCampanas; }