Asistente para la configuración de TableAdapter

Artículo
09/12/2015

El Asistente para 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 de una base de datos, 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 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 solo lectura sobre el proveedor seleccionado así como la cadena de conexión.

Guardar la cadena de conexión en el archivo de 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 proporcionado.

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 el 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 manera, no es necesario 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 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

En esta sección se explica cómo finalizar el Asistente para 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.

En la página Ver resultados del asistente se muestran los resultados de la creación de TableAdapter. Si el asistente detecta algún problema, esta pantalla proporciona información del error.

Elegir 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 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 un 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
Crea 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

En esta sección se explica cómo finalizar el Asistente para 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. Esta 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.
En la página Crear los procedimientos almacenados, haga lo siguiente:
1. Escriba un nombre para el nuevo procedimiento almacenado.
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.
En la página Ver resultados del asistente se muestran los resultados de la creación de TableAdapter. Si el asistente detecta algún problema, esta pantalla proporciona información del error.

Usar procedimientos almacenados existentes

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

Enlazar comandos a procedimientos almacenados existentes

Seleccione el procedimiento almacenado que desea 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().

Asigne 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 asignará 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.

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 las 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 simultaneidad.
Actualizar la 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 contiene 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 arrastre los elementos hasta los formularios 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

Compartir a través de