Cómo: Ejecutar consultas de TableAdapter

Artículo
10/07/2008

Actualización: noviembre 2007

Las consultas de TableAdapter son instrucciones SQL o procedimientos almacenados que la aplicación puede ejecutar en una base de datos y que se exponen como métodos con tipo en el TableAdapter. Puede ejecutar las consultas del TableAdapter llamando a los métodos asociados, como con cualquier método en cualquier objeto.

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.

Crear una instancia del TableAdapter

Debe crear una instancia del TableAdapter antes de poder llamar a cualquiera de sus métodos.

Nota:
Aunque los TableAdapters se crean y editan con el Diseñador de DataSet, en realidad no son clases anidadas dentro de un conjunto de datos. Los TableAdapters se encuentran en un espacio de nombres que se identifica basándose en el nombre del conjunto de datos asociado al TableAdapter. La convención de nomenclatura es: DataSetName + "TableAdapters". Por ejemplo, todos los TableAdapters asociados con el conjunto NorthwindDataSet se encontrarán en el espacio de nombres NorthwindDataSetTableAdapters. Si existe un CustomersTableAdapter, su nombre completo sería NorthwindDataSetTableAdapters.CustomersTableAdapter.

Aunque los TableAdapters se crean y editan con el Diseñador de DataSet, en realidad no son clases anidadas dentro de un conjunto de datos. Los TableAdapters se encuentran en un espacio de nombres que se identifica basándose en el nombre del conjunto de datos asociado al TableAdapter. La convención de nomenclatura es: DataSetName + "TableAdapters". Por ejemplo, todos los TableAdapters asociados con el conjunto NorthwindDataSet se encontrarán en el espacio de nombres NorthwindDataSetTableAdapters. Si existe un CustomersTableAdapter, su nombre completo sería NorthwindDataSetTableAdapters.CustomersTableAdapter.

Para crear una instancia del TableAdapter

Arrastre elementos de la ventana Orígenes de datos a un formulario de la aplicación para Windows para crear automáticamente una instancia de un TableAdapter en el formulario. Inspeccione el nombre de la instancia del TableAdapter en la bandeja de componentes (el área pequeña debajo del borde inferior del formulario).

O bien,
Después de crear un TableAdapter, genere el proyecto. El TableAdapter aparece en el Cuadro de herramientas. Arrastre el TableAdapter del Cuadro de herramientas a un formulario para crear una instancia. Inspeccione el nombre de la instancia del TableAdapter en la bandeja de componentes.

O bien,

Cree una instancia del TableAdapter mediante programación:

Dim CustomersTableAdapter1 As NorthwindDataSetTableAdapters.CustomersTableAdapter
CustomersTableAdapter1 = New NorthwindDataSetTableAdapters.CustomersTableAdapter()

NorthwindDataSetTableAdapters.CustomersTableAdapter customersTableAdapter1;
customersTableAdapter1 = new NorthwindDataSetTableAdapters.CustomersTableAdapter();

Ejecutar consultas del TableAdapter que rellenan tablas de datos existentes (métodos Fill())

Para ejecutar una consulta de TableAdapter que rellena una tabla de datos existente

Llame a la consulta Fill o FillBy del TableAdapter y pase la tabla de datos para rellenar. Por ejemplo, el código siguiente ejecuta la consulta Fill y rellena la tabla Customers:
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

Ejecutar consultas del TableAdapter que devuelven nuevas tablas de datos (métodos GetData())

Para ejecutar una consulta de TableAdapter que devuelve una nueva tabla de datos

Llame a la consulta GetData o GetDataBy del TableAdapter para devolver una tabla de datos con tipo rellenada con los resultados de la consulta. Por ejemplo, el código siguiente ejecuta la consulta GetData y devuelve una tabla Customers:
```
Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()
```
```
NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();
```

Ejecutar consultas del TableAdapter que devuelven valores únicos (escalares)

Puede arrastrar directamente una consulta del Cuadro de herramientas al Diseñador de DataSet para crear una consulta independiente (una consulta sin tabla de datos).

Para ejecutar una consulta de TableAdapter que devuelve un valor único (escalar)

Cree una instancia del TableAdapter, declare una variable para contener el valor devuelto y asígnele el resultado de la consulta. El ejemplo siguiente supone que hay que una consulta con el nombre CustomerCount en QueriesTableAdapter.

Dim scalarQueriesTableAdapter As NorthwindDataSetTableAdapters.QueriesTableAdapter
scalarQueriesTableAdapter = New NorthwindDataSetTableAdapters.QueriesTableAdapter()

Dim returnValue As Integer
returnValue = CType(scalarQueriesTableAdapter.CustomerCount(), Integer)

NorthwindDataSetTableAdapters.QueriesTableAdapter scalarQueriesTableAdapter;
scalarQueriesTableAdapter = new NorthwindDataSetTableAdapters.QueriesTableAdapter();

int returnValue;
returnValue = (int)scalarQueriesTableAdapter.CustomerCount();

Vea también