Asistente para la configuración del adaptador de datos

El Asistente para la configuración del adaptador de datos ayuda a establecer las propiedades de un adaptador de datos nuevo o ya existente. Un adaptador de datos contiene comandos SQL que su aplicación puede utilizar para leer los datos de un conjunto de datos de una base de datos y volver a escribirlos en ella de nuevo. El asistente puede también crear una conexión de datos que permita al adaptador comunicarse con una base de datos.

La configuración de un adaptador de datos es uno de los pasos que implica el uso de un conjunto de datos en la aplicación. Después de ejecutar el asistente, aún es necesario agregar de forma independiente un conjunto de datos a la aplicación y escribir código para proporcionar al adaptador un medio para que funcione con el conjunto de datos.

Nota

En la versión anterior de Visual Studio, los adaptadores de datos se utilizaban para la comunicación de la aplicación con una base de datos. Aunque los adaptadores de datos siguen siendo un componente fundamental de los Proveedores de datos .NET Framework (ADO.NET), los TableAdapters son componentes generados por el diseñador que simplifican el proceso de manipulación de datos entre su aplicación y una base de datos. Para obtener más información sobre cómo trabajar con objetos TableAdapters, vea Información general sobre TableAdapter.

Ejecutar el Asistente

El asistente se puede ejecutar para crear nuevos adaptadores o para editar los existentes. Asimismo, se puede ejecutar el asistente para cambiar las propiedades de un adaptador.

Para ejecutar el asistente

1. Siga uno de estos procedimientos:

   • Si va a crear un nuevo adaptador, arrastre un objeto adaptador de datos del cuadro de herramientas a un formulario o componente.

   • Si va a editar un adaptador existente, selecciónelo en el formulario o componente y, a continuación, elija Configurar adaptador de datos en el menú contextual.

   El asistente se iniciará.

2. Especifique la información sobre la conexión y los comandos SQL. Para ayudarle, el asistente muestra varios cuadros de diálogo:

   • Si solicita crear una conexión, el asistente muestra la ficha Conexión del Agregar/Modificar conexión (Cuadro de diálogo, General), que le permite especificar un proveedor, un nombre de servidor, un nombre de base de datos, un nombre de usuario y una contraseña para la conexión.

   • Para ayudarle a crear instrucciones SQL, el asistente proporciona el Generador de consultas, una utilidad que permite crear y probar instrucciones Select usando herramientas visuales. Para iniciarlo, haga clic en el botón Generador de consultas cuando se le pida una instrucción SQL. Para obtener más información, vea Herramientas de diseño de consultas y vistas.

     Sugerencia
     Si especifica que desea crear procedimientos almacenados, haga clic en Vista previa de script SQL para ver el script que usaría el asistente para realizar esta operación. Puede copiar este script y modificarla para crear sus propios procedimientos.

   Nota

   Aunque haga clic en el botón Cancelar del asistente, el adaptador se creará, pero no se establecerán sus propiedades. Sus propiedades se pueden establecer manualmente en la ventana Propiedades, o bien, puede ejecutar el asistente de nuevo.

Función del asistente

El Asistente para la configuración del adaptador de datos guía al usuario a lo largo de todo el proceso de creación de un adaptador de datos (y, si es necesario, de una conexión de datos). El asistente realiza las funciones siguientes:

• Crea el adaptador.

• Si es necesario, crea una conexión de datos y configura el adaptador para que la utilice.

• Crea las instrucciones SQL o los procedimientos almacenados necesarios para leer y escribir datos.

• Crea y configura parámetros para las instrucciones SQL o los procedimientos almacenados de forma que los comandos lean y escriban los datos adecuados.

• Asigna los nombres de tablas y columnas entre la base de datos y el conjunto de datos.

Configurar los objetos Command

La parte principal del trabajo del asistente consiste en la configuración de cuatro objetos Command de datos que usa el adaptador para pasar datos a la base de datos y desde ella. Éstos incluyen el objeto SelectCommand y, opcionalmente, los objetos UpdateCommand, InsertCommand y DeleteCommand. Cada uno de estos objetos contiene una instrucción SQL o el nombre de un procedimiento almacenado usado para leer y escribir datos. Las propiedades de cada uno de estos comandos (especialmente la propiedad CommandText) se establecen según las elecciones realizadas en el asistente.

El asistente permite usar instrucciones SQL o procedimientos almacenados para los comandos. Ofrece las siguientes opciones:

• Usar instrucciones SQL. Se puede especificar una instrucción Select y, si así se decide, el asistente creará las instrucciones Update, Insert y Delete correspondientes basándose en el contenido de la instrucción Select. Las instrucciones Update e Insert incluyen parámetros para pasar nuevos valores. Las instrucciones Delete, incluyen parámetros en una cláusula WHERE para localizar el registro adecuado de la base de datos.

• Crear nuevos procedimientos almacenados. Esta opción es similar a usar una instrucción, excepto en que el asistente genera procedimientos almacenados en lugar de instrucciones. Al ser los procedimientos almacenados más rápidos que las instrucciones SQL, elegir esta opción mejora el rendimiento. En esta opción el asistente genera procedimientos almacenados para los cuatro comandos (basándose igualmente en el contenido del comando Select). Se puede elegir que los nuevos procedimientos almacenados se escriban en la base de datos. Si no se hace, también se puede capturar el script SQL que utilizaría el asistente para crear los procedimientos almacenados, y ejecutarla posteriormente.

• Utilizar procedimientos almacenados existentes. En esta opción se seleccionan los procedimientos almacenados para cada uno de los cuatro comandos. El asistente muestra los nombres y detalles de los procedimientos que puede encontrar en la base de datos. Esta opción resulta útil si ya se tienen procedimientos almacenados que realicen las cuatro operaciones de base de datos.

Opciones avanzadas del Asistente

El asistente ofrece opciones avanzadas que permiten controlar la creación de los comandos Update, Insert y Delete para el adaptador de datos. Se puede abrir el cuadro de diálogo Opciones de generación SQL avanzadas del panel Generar instrucciones SQL del asistente; para ello, basta con hacer clic en el botón Opciones avanzadas.

Este cuadro de diálogo permite especificar las opciones siguientes:

• Generar instrucciones Insert, Update y Delete. Indica que el adaptador de datos generará instrucciones o procedimientos almacenados adicionales, basados en la instrucción Select, para escribir datos en la base de datos. Si el adaptador se va a utilizar sólo para leer datos y no para actualizarlos, dejar esta casilla sin marcar puede dar lugar a un código más eficaz.

• Usar simultaneidad optimista. Indica que se desea que el asistente incluya lógica para comprobar si un registro cambió desde que se leyó de la base de datos.

• Actualizar el conjunto de datos. Hace que el asistente genere código que vuelva a leer un registro de la base de datos después de actualizarlo. Esta operación proporciona una vista actualizada de un registro, incluidos los valores insertados por la base de datos, como los predeterminados y los de incremento automático.

Para obtener más información, vea Opciones de generación SQL avanzadas (Cuadro de diálogo).

Pasos siguientes

Una vez que el asistente ha concluido, el adaptador de datos (y opcionalmente, la conexión) se agregan al formulario. Después de eso se pueden llevar a cabo algunos pasos, unos se realizan casi siempre, mientras que otros son opcionales.

Pasos que podrían ser necesarios

Los pasos siguientes se realizan a menudo una vez que el Asistente para la configuración del adaptador de datos ha finalizado:

• Agregar más adaptadores de datos. El asistente crea un adaptador de datos. Normalmente, cada adaptador de datos se utiliza para leer y escribir datos en una única tabla de datos. Si se pretende usar un conjunto de datos que contenga varias tablas, probablemente se deseará agregar más adaptadores de datos al formulario o componente. Cada vez que se agrega un adaptador de datos desde el Cuadro de herramientas, hay que volver a ejecutar el asistente para configurarlo.

• Cambiar las asignaciones de tablas de un adaptador. De forma predeterminada, el asistente supone que leerá y escribirá en tablas y columnas con los mismos nombres. Sin embargo, se puede usar el adaptador para leer desde una base de datos que utilice un nombre en un conjunto de datos que utilice nombres distintos; o puede leer más columnas de la base de datos, de las que necesita en el conjunto de datos.

• Agregar lógica para rellenar el conjunto de datos. Para usar el adaptador de datos con el fin de rellenar un conjunto de datos se llama al método Fill del adaptador. De este modo se ejecuta el comando en el objeto SelectCommand del adaptador y se incluyen los resultados en el conjunto de datos. Para obtener más información, vea Rellenar un objeto DataSet desde un objeto DataAdapter (ADO.NET).

Vea también

Referencia

Asistente para la configuración de TableAdapter

Conceptos

Enlazar controles a los datos en Visual Studio

Otros recursos

Información general de las aplicaciones de datos en Visual Studio

Conectarse a datos en Visual Studio

Preparar la aplicación para recibir datos

Buscar datos en la aplicación

Modificar datos en la aplicación

Validar datos

Guardar datos