Vista previa del adaptador de datos (Cuadro de diálogo)

Artículo
08/10/2011

Permite ver cómo se rellenarán los datos en un conjunto de datos cuando se invoque un objeto SelectCommand de un adaptador. La utilización de este cuadro de diálogo permite comprobar que el adaptador devuelve los datos esperados, que las asignaciones de tablas funcionan correctamente y que no se producen errores al rellenar el conjunto de datos. Asimismo, el cuadro de diálogo también permite probar el efecto de pasar distintos valores de parámetros al adaptador.

Nota

En la versión anterior de Visual Studio, los adaptadores de datos se utilizaban para la comunicación de la aplicación con una base de datos. Aunque los adaptadores de datos siguen siendo un componente fundamental de los Proveedores de datos .NET Framework (ADO.NET), los TableAdapters son componentes generados por el diseñador que simplifican el proceso de manipulación de datos entre su aplicación y una base de datos. Para obtener más información sobre cómo trabajar con objetos TableAdapters, vea Información general sobre TableAdapter.

La vista previa de un adaptador de datos resulta particularmente útil cuando si se usa para rellenar un conjunto de datos que no se generó directamente a partir del adaptador.

El cuadro de diálogo aparece cuando se realiza cualquiera de las acciones siguientes:

En el menú Datos, seleccione Vista previa de datos. Este menú sólo está disponible cuando se agregó un adaptador de datos a un formulario o componente.
Haga clic en el vínculo Vista previa de datos de la parte inferior de la ventana Propiedades. Este vínculo está disponible cuando se muestran las propiedades de un adaptador de datos.

Lista de elementos de la interfaz de usuario

Adaptadores de datos
Contiene la lista de adaptadores de datos disponibles en el formulario o componente con el que se está trabajando. Seleccione el adaptador cuya vista previa desee mostrar. Para mostrar los resultados del uso de todos los adaptadores de datos, seleccione <Todos los adaptadores de datos>.
Rellenar conjunto de datos
Ejecuta el comando y muestra los datos en el cuadro Resultados.

Si se produce un error mientras el adaptador de datos está rellenando los datos en el conjunto, éste se mostrará en un cuadro de mensajes. Los errores posibles incluyen:
- No coincidencia de los tipos de datos.
- Errores de sintaxis en la instrucción SQL o procedimiento almacenado que se está ejecutando.
- Errores de asignación de tablas. Por ejemplo, si se establecen las propiedades MissingMappingAction o MissingSchemaAction de un adaptador en Error, y si las asignaciones de tablas no describen exactamente qué hacer con los nombres de columnas que no coinciden en la base de datos y el conjunto de datos, se producirá un error.
- Problemas de conexión.
Parámetros
Muestra los parámetros necesarios para la instrucción SELECT SQL o el procedimiento almacenado a que se hace referencia en el objeto SelectCommand del adaptador o adaptadores de datos especificados. Si no se precisa ningún parámetro, esta cuadrícula aparece en blanco.

Cada parámetro aparece como una fila en la cuadrícula con su nombre y el tipo de datos rellenado. Especifique un valor para cada parámetro del cuadro Valor. Como alternativa, si el parámetro lo admite, puede seleccionar <DEFAULT> o <NULL> en la lista desplegable del cuadro Valor.
Conjunto de datos de destino
Determina el conjunto de datos en el que el comando de vista preliminar debe rellenar los datos. Se puede seleccionar de entre todos los conjuntos de datos disponibles en el proyecto o puede seleccionar rellenar un conjunto de datos sin tipo (uno sin un esquema).
Tablas de datos
Muestra una lista de las tablas de datos del conjunto. Seleccione un nombre de tabla para ver los registros rellenados por el adaptador de datos. (Normalmente, cada adaptador de datos rellena una tabla del conjunto de datos). En el caso de que el adaptador haya rellenado más de una tabla, basta con seleccionar el nombre de ésta en la lista para ver sus resultados.
Resultados
Muestra los datos del conjunto de datos. El cuadro muestra cómo aparecerá la información una vez devuelta por la base de datos y después de aplicadas las asignaciones de tablas. Los datos de la cuadrícula son de sólo lectura.

Si hay más de una tabla en los resultados, se puede ver el contenido de una tabla determinada seleccionando su nombre en la lista Tabla de datos.
Borrar resultados
Elimina todos los datos de la tabla seleccionada. Para borrar todas las tablas, selecciónelas una a una en la lista Tablas de datos y haga clic en Borrar resultados para cada una de ellas.