Cómo: Asignar columnas de orígenes de datos a columnas de tablas de datos del conjunto de datos

Artículo
10/07/2008

Actualización: noviembre 2007

La creación de una asignación en un adaptador de datos permite establecer una correspondencia entre las columnas del origen de datos y las columnas de una tabla del conjunto de datos. Para obtener más información, vea Asignaciones de tablas en adaptadores de datos.

Nota:
En la versión anterior de Visual Studio, los adaptadores de datos se usaban para las comunicaciones entre una aplicación y una base de datos. Mientras que los adaptadores de datos aún son un componente principal de .Proveedores de datos de .NET Framework (ADO.NET), los objetos TableAdapters son componentes generados por diseñador que simplifican el proceso de mover datos entre la aplicación y la base de datos. Para obtener más información sobre el trabajo con objetos TableAdapters, vea Información general sobre TableAdapter.

En la versión anterior de Visual Studio, los adaptadores de datos se usaban para las comunicaciones entre una aplicación y una base de datos. Mientras que los adaptadores de datos aún son un componente principal de .Proveedores de datos de .NET Framework (ADO.NET), los objetos TableAdapters son componentes generados por diseñador que simplifican el proceso de mover datos entre la aplicación y la base de datos. Para obtener más información sobre el trabajo con objetos TableAdapters, vea Información general sobre TableAdapter.

Para asignar columnas de un origen de datos a una tabla del conjunto de datos

Cree un adaptador de datos. Para obtener más información, vea Crear adaptadores de datos.
En un diseñador de formularios o componentes, seleccione el adaptador de datos y abra la ventana Propiedades.
Junto a la propiedad TableMappings, haga clic en el botón de puntos suspensivos (...). Se abre el cuadro de diálogo Asignaciones de tablas.

Si desea asignar nombres de columnas del origen de datos a un conjunto de datos existente, active Usar un conjunto de datos para sugerir nombres de tabla y de columna y, a continuación, seleccione un conjunto de datos en la lista DataSet.

Las tablas disponibles en el conjunto de datos aparecen en la lista Tabla de conjuntos de datos; las columnas de la primera tabla del conjunto de datos llenan el lado derecho de la cuadrícula Asignaciones de columnas.

Nota:
Elegir un conjunto de datos es una comodidad que permite al cuadro de diálogo Asignaciones establecer valores predeterminados para asignar columnas del conjunto de datos. El conjunto de datos no forma parte de la información que se mantiene para las asignaciones en el adaptador. Es más, es posible utilizar las mismas asignaciones con más de un conjunto de datos.

Bajo Tabla de origen, seleccione la tabla del origen de datos que se asignará. Si en el conjunto de datos sólo hay una tabla, el valor predeterminado es Table.
Bajo Tabla de conjuntos de datos, seleccione la tabla que se asignará del conjunto de datos. Si seleccionó un conjunto de datos para la asignación en el paso 3, ya se habrá proporcionado un nombre. De manera predeterminada, la primera tabla del conjunto de datos se denomina Table.

En función de las opciones elegidas (o de los valores predeterminados), se rellenan los valores de las listas Columnas de origen y Columnas de conjuntos de datos. La cuadrícula indica cómo se realizará la asignación: cada columna de la columna izquierda se asociará con la columna correspondiente en la columna de la derecha.
Ajuste las asignaciones según sea necesario. Esto puede incluir:
- Seleccionar columnas diferentes en las listas de columnas de origen o del conjunto de datos, para cambiar qué columnas se asignan a cuáles.
- Quitar columnas de la asignación. Puede hacer esto si el adaptador devuelve más columnas de las necesarias del origen de datos.
- Agregar columnas. Puede hacer esto si sabe que existirán columnas en tiempo de ejecución que no estén representadas en tiempo de diseño, o si eliminó una columna y desea recuperarla, o si refinó la consulta del adaptador y necesita ajustar las asignaciones.
Cuando termine de ajustar las asignaciones, haga clic en Aceptar.

Si desea especificar cómo controlar las posibles condiciones de error, seleccione las opciones de las propiedades MissingMappingAction y MissingSchemaAction en la ventana Propiedades. La tabla siguiente enumera algunas configuraciones comunes y su efecto.

MissingMappingAction	MissingSchemaAction	Efecto
Passthrough	Add O AddWithKey	Si una columna existe en el origen pero no en el esquema y no hay asignación para ella, la columna se crea al llenar el conjunto de datos. Ésta es la configuración predeterminada y es útil cuando simplemente se desea copiar en el conjunto de datos todas las columnas disponibles en el origen.
Ignore	Ignore	Si la columna no está definida en el esquema del conjunto de datos o no hay asignación para ella, la información no se copia del origen al conjunto de datos. Esta configuración es útil si el adaptador devuelve más información de la que se desea para el conjunto de datos.
Error	Error	Se produce un error en tiempo de ejecución si el adaptador no puede asignar una columna de origen a una columna del conjunto de datos porque falta la asignación o porque el esquema del conjunto de datos no contiene la columna. Esta configuración es útil cuando se está trabajando con un esquema definido rígidamente y se desea asegurar que queden marcadas todas las desviaciones del esquema.