Asistente para la configuración de consultas de TableAdapter

Artículo
08/10/2011

El Asistente para la configuración de consultas de TableAdapter ayuda a crear y editar las consultas adicionales que se pueden agregar a TableAdapters. Una consulta de TableAdapter es cualquier consulta SQL válida o cualquier procedimiento almacenado que devuelve datos que satisfacen el mismo esquema que la tabla de datos asociada de TableAdapter, o bien devuelve un valor escalar. Después de finalizar el asistente, se agrega un método al asistente TableAdapter que, cuando se le llama, ejecuta la consulta. (Por ejemplo, CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)

Ejecutar el Asistente

Arrastre las consultas al Diseñador de DataSet o configure las consultas existentes (cualquier consulta que aparezca debajo de la primera consulta).

La primera consulta en un TableAdapter es la consulta principal. Al editar esta consulta principal, se abre el Asistente para la configuración de TableAdapter y edita el esquema de la tabla de datos del TableAdapter. Todas las consultas que aparecen debajo de la consulta principal son consultas adicionales y se configuran utilizando el Asistente para la configuración de consultas de TableAdapter. Para obtener más información sobre cómo ejecutar el asistente, vea Cómo: Iniciar el Asistente para la configuración de consultas 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.

Usar instrucciones SQL

Esta sección explica cómo finalizar el Asistente para la configuración de consultas de TableAdapter al seleccionar la opción Usar instrucciones SQL.

Elija un tipo de consulta

El asistente crea varios tipos de consultas dependiendo de los requisitos de la aplicación. Puede elegir las consultas SELECT que devuelven filas de datos (una tabla de datos) o consultas SELECT que devuelven un valor escalar (un valor sencillo como Count o Sum).

En la página Elija un tipo de consulta, seleccione el tipo de consulta a crear a partir de la lista de consultas disponibles.

Nota

Crear una instrucción INSERT, UPDATE o DELETE no reemplaza los comandos del TableAdapter que se utilizan al llamar al método Update del TableAdapter. Por ejemplo, al seleccionar UPDATE como un tipo de consulta, se creará una nueva consulta con el nombre que especifique después en el asistente. El usuario ejecuta esta consulta llamando a este método con nombre del TableAdapter. Al llamar al método Update del TableAdapter, se ejecutarán instrucciones que se crearon cuando se configuró el TableAdapter original.

Especificar una instrucción SQL <tipo de consulta>

En la página Especificar una instrucción SQL, escriba la instrucción SQL para ejecutar al llamar a la consulta.

Sugerencia
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.

Elija los métodos que se van a generar

Esta página proporciona las opciones para seleccionar qué métodos genera el asistente para la consulta.

Rellenar un DataTable
Crea un método para rellenar la tabla de datos. El usuario pasa el nombre de la tabla de datos como un parámetro al llamar a este método para llenar la tabla de datos con los datos devueltos.

También puede cambiar el nombre predeterminado en el cuadro Nombre de método. Proporcionar un nombre descriptivo puede ser útil al trabajar con esta consulta en código.
Devolver un DataTable
Crea un método para devolver una tabla de datos llena. 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.

Elegir un nombre de función

Escriba un nombre para la función. Al crear una consulta de TableAdapter, se agrega un método al TableAdapter con el nombre que se proporcionó aquí. Llame a este método para ejecutar la consulta. Proporcionar un nombre descriptivo es útil al trabajar con esta consulta en código.

Nota

Al crear los nuevos procedimientos almacenados, se le piden dos nombres. El primero es el nombre del procedimiento almacenado creado en la base de datos; el segundo, es el nombre del método en el TableAdapter que ejecuta el procedimiento almacenado cuando se le llama.

Crear nuevos procedimientos almacenados

Esta sección explica cómo finalizar el Asistente para la configuración de consultas 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 se va a ejecutar al llamar al procedimiento almacenado.

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 de seguridad determina la capacidad de crear un procedimiento almacenado en la base de datos para la base de datos concreta.
La página Ver resultados del asistente muestra los resultados de la creación de la consulta de TableAdapter. Si el asistente detecta algún problema, esta pantalla proporciona la información de error.

Usar procedimientos almacenados existentes

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

Seleccione un procedimiento almacenado existente a partir de la lista desplegable de la página del asistente Elija un procedimiento almacenado existente.

Aparecen como referencia Parámetros y Resultados para el procedimiento almacenado seleccionado.
Haga clic en Siguiente.

Elija la forma de los datos devueltos por el procedimiento almacenado

El tipo de datos devuelto por el procedimiento almacenado seleccionado determina cómo el asistente crea los métodos del TableAdapter.

Seleccione el tipo de datos devuelto por esta consulta.

Al seleccionar Datos en formato de tabla, se abre la página Elija los métodos que se van a generar (descrita antes en esta página de Ayuda), la cual permite especificar los tipos de métodos, nombres de método y compatibilidad de paginación que se van a crear.
Al seleccionar Un solo valor, se crea un método con tipo que devuelve un valor único. Esta opción abre la página Elija un nombre de función (descrita antes en esta página de Ayuda).
Al seleccionar Sin valores, se crea un método con tipo que ejecuta el procedimiento almacenado y espera que no se devuelvan datos. Esta opción abre la página Elija un nombre de función (descrita antes en esta página de Ayuda).

Ver los resultados de los asistentes

La página Ver resultados del asistente muestra los resultados de la creación de la consulta de TableAdapter. Si el asistente detecta problemas, los detalles aparecen en esta pantalla.

Vea también

Compartir a través de