Cómo: Crear consultas de TableAdapter
Publicada: julio de 2016
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:
string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);
Dim cityValue As String = "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 tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. 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, consulta Personalizar el IDE 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).
Vea también
Información general sobre TableAdapter
Cómo: Editar consultas de TableAdapter
Crear y editar conjuntos de datos con tipo
Información general sobre orígenes de datos
Cómo: Conectarse a los datos de una base de datos
Validar datos
Cómo: Explorar datos con el control BindingNavigator de formularios Windows Forms
Tutorial: Mostrar datos en Windows Forms
Tutorial: Crear un objeto TableAdapter con varias consultas