Cómo: Crear y ejecutar una instrucción SQL que no devuelva ningún valor

Actualización: noviembre 2007

Para ejecutar una instrucción SQL que no devuelva valores, puede ejecutar una consulta de TableAdapter configurada para ejecutar una instrucción SQL (por ejemplo, CustomersTableAdapter.UpdateTableData(CustomersDataTable)).

Si la aplicación no utiliza TableAdapters, llame al método ExecuteNonQuery en un objeto de comando, estableciendo su propiedad CommandType en Text. (El objeto "Command" se refiere al comando concreto para el Proveedor de datos de .NET Framework que la aplicación está utilizando. Por ejemplo, si la aplicación está utilizando el Proveedor de datos de .NET Framework para servidor SQL Server, el objeto de comando sería SqlCommand.)

Los ejemplos siguientes muestran cómo ejecutar instrucciones SQL que no devuelva ningún valor desde una base de datos utilizando TableAdapters u objetos de comando. Para obtener más información sobre cómo realizar consultas con TableAdapters y comandos, vea Información general sobre cómo rellenar conjuntos de datos y consultar datos.

Ejecutar instrucciones SQL que no devuelvan valores mediante un TableAdapter

Este ejemplo muestra cómo crear una consulta de TableAdapter mediante Asistente para la configuración de consultas de TableAdaptery, a continuación, proporciona información sobre cómo declarar una instancia del TableAdapter y ejecutar la consulta.

Nota:

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Para crear una instrucción SQL que no devuelva valores mediante un TableAdapter

  1. Abra un conjunto de datos en el Diseñador de Dataset. Para obtener más información, vea Cómo: Abrir un objeto Dataset en el Diseñador de Dataset.

  2. Si no tiene uno, cree un TableAdapter. Para obtener más información sobre la creación de TableAdapters, vea Cómo: Crear TableAdapters.

  3. Si ya tiene una consulta en el TableAdapter que utiliza una instrucción SQL y que no devuelve ningún valor, pase al procedimiento siguiente, "Para declarar una instancia del TableAdapter y ejecutar la consulta". De lo contrario, continúe con el paso 4 para crear una nueva consulta que no devuelva ningún valor.

  4. Haga clic con el botón secundario del mouse (ratón) en el TableAdapter deseado y utilice el menú contextual para agregar una consulta.

    El Asistente para la configuración de consultas de TableAdapter se abre.

  5. Deje el valor predeterminado de Usar instrucciones SQLy, a continuación, haga clic en Siguiente.

  6. Elija la opción UPDATE, INSERT o DELETE y, a continuación, haga clic en Siguiente.

  7. Escriba la instrucción SQL o utilice el Generador de consultas para crear una y, a continuación, haga clic en Siguiente.

  8. Proporcione un nombre para la consulta.

  9. Finalice el asistente; la consulta se agrega al TableAdapter.

  10. Generar el proyecto.

Para declarar una instancia del TableAdapter y ejecutar la consulta

  1. Declare una instancia del TableAdapter que contenga la consulta que desea ejecutar.

    • Para crear una instancia mediante las herramientas en tiempo de diseño, arrastre el TableAdapter que desee desde el Cuadro de herramientas. (Los componentes del proyecto aparecen ahora en el Cuadro de herramientas debajo de un encabezado que coincide con el nombre del proyecto.) Si el TableAdapter no aparece en el Cuadro de herramientas, quizá deba generar su proyecto.

      O bien

    • Para crear una instancia en código, reemplace el código siguiente con los nombres de DataSet y TableAdapter.

      Dim tableAdapter As New DataSetTableAdapters.TableAdapter

      Nota:

      Los TableAdapters no se encuentran dentro de sus clases de conjunto de datos asociadas. Cada conjunto de datos tiene una colección correspondiente de TableAdapters en su propio espacio de nombres. Por ejemplo, si tiene un conjunto de datos denominado SalesDataSet, debe haber un espacio de nombres SalesDataSetTableAdapters que contiene su TableAdapters.

  2. Llame a su consulta de la misma forma que llamaría a cualquier otro método en código. Su consulta es un método en el TableAdapter. Reemplace el código siguiente con los nombres de su TableAdapter y consulta. También debe pasar cualquier parámetro requerido por la consulta. Si no está seguro de si su consulta requiere parámetros, o qué parámetros requiere, busque en IntelliSense la firma necesaria de la consulta. Dependiendo de si su consulta toma parámetros o no, el código se parecería al de uno de los ejemplos siguientes:

    TableAdapter.Query()

    TableAdapter.Query(Parameters)

    Las consultas que creemos que no devuelve ningún valor, realmente sí lo devuelven: un entero que contiene el número de filas afectadas por la consulta. El código completo para declarar una instancia de un TableAdapter y ejecutar una consulta debe lucir similar a lo siguiente:

    Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()
    
    Dim rowsAffected As Integer
    rowsAffected = CType(tableAdapter.UpdateContactTitle("Sales Manager", "ALFKI"), Integer)
    
    NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = 
        new NorthwindDataSetTableAdapters.CustomersTableAdapter();
    
    int rowsAffected = tableAdapter.UpdateContactTitle("Sales Manager", "ALFKI");
    

Ejecutar instrucciones SQL que no devuelvan valores mediante un objeto de comando

El ejemplo siguiente muestra cómo crear un comando y ejecutar una instrucción SQL que no devuelve valores. Para obtener información sobre cómo configurar y obtener valores de parámetro para un comando, vea Cómo: Establecer y obtener parámetros para objetos de comandos.

Este ejemplo utiliza el objeto SqlCommand y requiere:

  • Hace referencia a los espacios de nombres System, System.Data y System.Xml.

  • Una conexión de datos denominada SqlConnection1.

  • Una tabla denominada Customers en el origen de datos a la cual se conecta SqlConnection1. (De lo contrario, será necesario una instrucción SQL válida para el origen de datos).

Para ejecutar una instrucción SQL que no devuelva ningún valor mediante un DataCommand

  • Agregue el código siguiente a un método desde donde desee que se ejecute la instrucción SQL. Llame al método ExecuteNonQuery de un comando para no devolver valores (por ejemplo, SqlCommand.ExecuteNonQuery).

    Dim sqlConnection1 As New SqlConnection("Your Connection String")
    Dim cmd As New SqlCommand
    Dim rowsAffected As Integer
    
    cmd.CommandText = "UPDATE Customers SET ContactTitle = 'Sales Manager' WHERE CustomerID = 'ALFKI'"
    cmd.CommandType = CommandType.Text
    cmd.Connection = sqlConnection1
    
    sqlConnection1.Open()
    
    rowsAffected = cmd.ExecuteNonQuery()
    
    sqlConnection1.Close()
    
    SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
    SqlCommand cmd = new SqlCommand();
    Int32 rowsAffected;
    
    cmd.CommandText = "UPDATE Customers SET ContactTitle = 'Sales Manager' WHERE CustomerID = 'ALFKI'";
    cmd.CommandType = CommandType.Text;
    cmd.Connection = sqlConnection1;
    
    sqlConnection1.Open();
    
    rowsAffected = cmd.ExecuteNonQuery();
    
    sqlConnection1.Close();
    

Seguridad

La aplicación necesita permiso para tener acceso a la base de datos y ejecutar la instrucción SQL.

Vea también

Tareas

Cómo: Crear consultas de TableAdapter

Cómo: Editar consultas de TableAdapter

Cómo: Llenar un conjunto de datos con datos

Cómo: Establecer y obtener parámetros para objetos de comandos

Conceptos

Información general sobre cómo rellenar conjuntos de datos y consultar datos

Referencia

SqlCommand.ExecuteNonQuery

OleDbCommand.ExecuteNonQuery

OdbcCommand.ExecuteNonQuery

OracleCommand.ExecuteNonQuery