¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
Importante Es posible que este documento no represente los procedimientos recomendados para el desarrollo actual. Puede que los vínculos a las descargas y otros recursos ya no sean válidos. Encontrará aquí la versión que se recomienda en la actualidad.

Cómo: Ejecutar consultas de TableAdapter

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.

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

ms233822.alert_note(es-es,VS.90).gifNota:

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:

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

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);
    
    
    

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:

    NorthwindDataSet.CustomersDataTable newCustomersTable;
    newCustomersTable = customersTableAdapter1.GetData();
    
    
    

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.

    NorthwindDataSetTableAdapters.QueriesTableAdapter scalarQueriesTableAdapter;
    scalarQueriesTableAdapter = new NorthwindDataSetTableAdapters.QueriesTableAdapter();
    
    int returnValue;
    returnValue = (int)scalarQueriesTableAdapter.CustomerCount();
    
    
    

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft