Cómo: Crear consultas de TableAdapter

Artículo
02/19/2013

Las consultas del TableAdapter son instrucciones SQL o procedimientos almacenados que puede ejecutar su aplicación en una base de datos.

Agregue tantas consultas a un TableAdapter como sea necesario para su aplicación.Las consultas de TableAdapter aparecen como métodos en un TableAdapter.Cuando crea que una consulta llamada FillByCity que toma un parámetro que representa el valor de ciudad, la consulta se agrega al TableAdapter.Se agrega como método de tipo y toma como argumento el tipo correcto de parámetro, en este caso una cadena que representa el valor de ciudad.A la consulta de TableAdapter se la llama exactamente igual que a cualquier método u objeto.Por ejemplo, el código siguiente ejecuta la consulta FillByCity y rellena la tabla Customers con todos los clientes con un valor de ciudad de Seattle:

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

Las consultas de TableAdapter pueden rellenar una tabla de datos (consultas Fill y FillBy) o devolver nuevas tablas de datos rellenadas con los datos devueltos por la consulta (consultas GetData y GetDataBy).

Puede agregar consultas a TableAdapters existente ejecutando Asistente para la configuración de consultas de TableAdapter.(Haga clic con el botón secundario del mouse en cualquier TableAdapter y elija Agregar consulta.)

[!NOTA]

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio.

Crear una consulta en el Diseñador de DataSet

Para agregar una consulta a un TableAdapter en el Diseñador de DataSet

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.
Haga clic con el botón secundario del mouse en el TableAdapter deseado y seleccione Agregar consulta.

O bien
Arrastre una Consulta desde la ficha DataSet del Cuadro de herramientas hasta una tabla del diseñador.

El Asistente para la configuración de consultas de TableAdapter se abre.
Finalice el asistente; la consulta se agrega al TableAdapter.

Crear una consulta directamente en un formulario de su aplicación para Windows

Si tiene una instancia de un TableAdapter en su formulario, puede agregar una consulta mediante el Generador de criterios de búsqueda (cuadro de diálogo), que agregue al formulario un control ToolStrip que acepte cualquier parámetro de entrada requerido por la consulta, así como un botón para ejecutar la consulta.

Para agregar una consulta a un TableAdapter utilizando el cuadro de diálogo Criterios de búsqueda

Seleccione un TableAdapter en la bandeja de componentes.
Haga clic en la etiqueta inteligente del TableAdapter y elija Agregar consulta.
Finalice el cuadro de diálogo y la consulta se agregará al TableAdapter.Para obtener más información, vea Generador de criterios de búsqueda (cuadro de diálogo).