Cómo: Crear consultas de TableAdapter

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

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas. Para obtener más información, vea Trabajar con valores de configuración.

Crear una consulta en el Diseñador de DataSet

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

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

  2. Haga clic con el botón secundario del mouse en el TableAdapter deseado y seleccione Agregar consulta.

    O bien

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

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

  1. Seleccione un TableAdapter en la bandeja de componentes.

  2. Haga clic en la etiqueta inteligente del TableAdapter y elija Agregar consulta.

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

Tareas

Cómo: Editar consultas de TableAdapter

Cómo: Conectarse a los datos de una base de datos

Cómo: Explorar datos con el control BindingNavigator de formularios Windows Forms

Tutorial: Mostrar datos en un formulario Windows Forms

Tutorial: Crear un objeto TableAdapter con varias consultas

Conceptos

Información general sobre TableAdapter

Diseñador de DataSet

Información general sobre orígenes de datos

Otros recursos

Validar datos