Asistente para la configuración de TableAdapter

Artículo
08/10/2011

El Asistente para la configuración de TableAdapter crea y edita adaptadores TableAdapter. El asistente crea objetos TableAdapters basados en instrucciones SQL especificadas o incluidas en los procedimientos almacenados existentes en la base de datos. El asistente también puede crear nuevos procedimientos almacenados en la base de datos de acuerdo con las instrucciones SQL que se especifican en el asistente.

Los objetos TableAdapter se conectan a una base de datos, ejecutan consultas o procedimientos almacenados y rellenan tablas DataTable con los datos devueltos por la consulta o el procedimiento almacenado. Además de rellenar las tablas de datos existentes, los objetos TableAdapters pueden devolver nuevas tablas rellenas con datos. Para obtener más información, vea Información general sobre TableAdapter.

Ejecutar el Asistente

Ejecute el asistente para crear o editar objetos TableAdapters y los objetos DataTables asociados. Para obtener más información, vea Cómo: Iniciar el Asistente para la configuración de TableAdapter.

Elegir la conexión de datos

Elija una conexión existente de la lista de conexiones o haga clic en Nueva conexión para abrir Agregar/Modificar conexión (Cuadro de diálogo, General) y crear una conexión a su base de datos.

Después de completar el cuadro de diálogo Propiedades de la conexión, el área Detalles de conexión muestra la información de sólo lectura sobre el proveedor seleccionado así como la cadena de conexión.

Guarde la cadena de conexión en el archivo de la configuración de la aplicación

Elija Sí, guardar la conexión como para almacenar la cadena de conexión en el archivo de configuración de la aplicación. Escriba un nombre para la conexión o utilice el nombre predeterminado.

Las cadenas de conexión guardadas en el archivo de configuración de la aplicación simplifican el proceso de mantenimiento de la aplicación si se modifica la conexión a la base de datos. En caso de un cambio en la conexión a la base de datos, puede editar la cadena de conexión en el archivo de configuración de la aplicación. De esta forma, no tiene que editar el código fuente ni volver a compilar la aplicación. Para obtener información sobre cómo editar una cadena de conexión en el archivo de configuración de la aplicación, vea Cómo: Guardar y editar cadenas de conexión.

Nota sobre la seguridad
La información se almacena en el archivo de configuración de la aplicación como texto sin formato. Para reducir la posibilidad de un acceso no autorizado a información confidencial, puede que desee cifrar los datos. Para obtener más información, vea Cifrar y descifrar datos.

Elegir un tipo de comando

Elija qué tipo de comando desea ejecutar en la base de datos.

En la página Elija un tipo de comando, seleccione entre los métodos siguientes para obtener datos de la base de datos:

Usar instrucciones SQL permite escribir una instrucción SQL para seleccionar los datos de la base de datos.
Crear nuevos procedimientos almacenados: seleccione esta opción para hacer que el asistente cree nuevos procedimientos almacenados (en la base de datos) basándose en la instrucción SELECT especificada.
Usar procedimientos almacenados existentes: seleccione esta opción para asignar procedimientos almacenados que ya existen en la base de datos a los comandos SELECT, INSERT, UPDATE y DELETE del objeto TableAdapter.

Usar instrucciones SQL

Esta sección explica cómo finalizar el Asistente para la configuración de TableAdapter cuando se selecciona la opción Usar instrucciones SQL.

En la página Generar las instrucciones SQL, escriba la instrucción SQL que, al ejecutarse, rellenará la tabla con datos.

Nota

El asistente proporciona acceso al Generador de consultas, una herramienta visual para crear consultas SQL. Para abrirlo, haga clic en el botón Generador de consultas. Para obtener más información sobre cómo utilizar el Generador de consultas, vea Herramientas de diseño de consultas y vistas.

La página Ver resultados del asistente muestra los resultados de la creación de TableAdapter. Si el asistente encuentra algún problema, esta página proporciona la información de error.

Elija los métodos que se van a generar

Esta página proporciona opciones para seleccionar qué métodos de TableAdapter genera el asistente para buscar y actualizar los datos.

Rellenar un DataTable
Crea el método predeterminado del TableAdapter para rellenar la tabla de datos. Pase el nombre de la tabla de datos como parámetro al llamar a este método.

También puede cambiar el nombre predeterminado en el cuadro Nombre de método.
Devolver un DataTable
Crea el método del TableAdapter para devolver una tabla de datos rellena. En ciertas aplicaciones, puede ser más atractivo devolver una tabla de datos llena a diferencia de llenar con datos la existente.

También puede cambiar el nombre predeterminado en el cuadro Nombre de método.
Crear métodos para enviar actualizaciones directamente a la base de datos
Cree los comandos INSERT, UPDATE y DELETE necesarios para escribir cambios en la base de datos subyacente. Activar esta casilla es equivalente a establecer la propiedad GenerateDBDirectMethods en True.

Nota

Esta opción no está disponible cuando la instrucción SQL original no proporciona bastante información o la consulta no es una consulta actualizable. Por ejemplo, esta situación se produce en consultas de tipo JOIN y en consultas que devuelven un único valor (escalar).

Crear nuevos procedimientos almacenados

Esta sección explica cómo finalizar el Asistente para la configuración de TableAdapter al seleccionar la opción Crear nuevos procedimientos almacenados.

En la página Generar los procedimientos almacenados, escriba la instrucción SQL que rellena la tabla de datos. Ésta será la instrucción SELECT de TableAdapter y la base para crear los procedimientos almacenados para la selección, actualización, inserción y eliminación de datos.

Nota

El asistente proporciona acceso al Generador de consultas, una herramienta visual para crear consultas SQL. Para abrirlo, haga clic en el botón Generador de consultas. Para obtener más información sobre cómo utilizar el Generador de consultas, vea Herramientas de diseño de consultas y vistas o presione F1 en ese cuadro de diálogo.
En la página Crear los procedimientos almacenados, haga lo siguiente:
1. Escriba un nombre para el nuevo procedimiento.
2. Especifique si se crea el procedimiento almacenado en la base de datos subyacente.
  
  Nota
  
  La configuración y permisos de seguridad de la base de datos específica determinan la capacidad para crear procedimientos almacenados en la base de datos. Por ejemplo, si no tiene permiso para crear nuevos procedimientos almacenados en la base de datos, esta opción no podrá finalizarse.
La página Ver resultados del asistente muestra los resultados de la creación de TableAdapter. Si el asistente encuentra algún problema, esta página proporciona la información de error.

Usar procedimientos almacenados existentes

Esta sección explica cómo finalizar el Asistente para la configuración de TableAdapter al seleccionar la opción Usar procedimientos almacenados existentes.

Enlazar comandos a procedimientos almacenados existentes

Seleccione el procedimiento almacenado que desee ejecutar para los comandos SELECT, INSERT, UPDATE y DELETE de TableAdapter. Estos procedimientos almacenados se ejecutan cuando se llama a los métodos asociados de TableAdapter. Por ejemplo, el procedimiento almacenado asignado al comando Update se ejecuta cuando se llama al método TableAdapter.Update().

Asignar parámetros desde el procedimiento almacenado seleccionado a las columnas correspondientes de la tabla de datos. Por ejemplo, si el procedimiento almacenado acepta un parámetro denominado @CompanyName que pasa a la columna CompanyName de la tabla, establezca la Columna de origen del parámetro @CompanyName en CompanyName.

Nota

El procedimiento almacenado asignado al comando SELECT se ejecuta llamando al método del objeto TableAdapter al que se asigna un nombre en el paso siguiente del asistente. El valor predeterminado es Fill, por lo que el código típico para ejecutar el procedimiento SELECT es TableAdapter.Fill(tableName). Sustituya Fill con el nombre que asigne si cambia el valor predeterminado de Rellenar, y reemplace "TableAdapter" por el nombre real del TableAdapter (por ejemplo, CustomersTableAdapter).

Opciones avanzadas

Al hacer clic en Opciones avanzadas, tendrá acceso a las siguientes opciones avanzadas de TableAdapter. Para obtener más información, vea Opciones de generación SQL avanzadas (Cuadro de diálogo).

Generar instrucciones Insert, Update y Delete

Cuando selecciona esta opción, el asistente intenta generar las instrucciones INSERT, UPDATE y DELETE basándose en la instrucción SELECT que se define en la página Generar instrucciones SQL.
Usar simultaneidad optimista

Al seleccionar esta opción, se modifican las instrucciones UPDATE y DELETE para detectar si se han modificado registros individuales desde que se leyeron originalmente en la tabla de datos. Se produce una excepción cuando se detectan infracciones de la simultaneidad.
Actualizar DataTable

Al seleccionar esta opción, se actualizan los datos de la tabla después de ejecutar las instrucciones INSERT y UPDATE.

Pasos siguientes

Una vez finalizado el asistente, el objeto TableAdapter se agrega al conjunto de datos y se puede ver y editar en el Diseñador de DataSet. Después de eso se pueden llevar a cabo algunos pasos,

Agregar más TableAdapters. El asistente crea un objeto TableAdapter. Si pretende usar un conjunto de datos que contenga varias tablas, probablemente deseará agregar más TableAdapters al conjunto de datos.
Agregar consultas adicionales al objeto TableAdapter. Para obtener más información, vea Cómo: Crear consultas de TableAdapter.
Ver este conjunto de datos en la Orígenes de datos (ventana) y arrastrar elementos hasta los formularios Windows Forms para crear controles enlazados a datos. Para obtener más información, vea Enlazar controles de Windows Forms a datos en Visual Studio.

Vea también