Cómo: Crear y configurar adaptadores de datos de forma manual

Artículo
10/07/2008

Actualización: noviembre 2007

Puede crear los adaptadores de datos sin utilizar un asistente. Independientemente de cómo se haya creado el adaptador, siempre podrá modificar su configuración.

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 de .NET Framework (ADO.NET), los TableAdapters son componentes generados por el diseñador que simplifican el proceso de mover datos entre su aplicación y una base de datos. Para obtener más información sobre cómo trabajar con TableAdapters, vea Información general sobre TableAdapter.

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 de .NET Framework (ADO.NET), los TableAdapters son componentes generados por el diseñador que simplifican el proceso de mover datos entre su aplicación y una base de datos. Para obtener más información sobre cómo trabajar con TableAdapters, vea Información general sobre TableAdapter.

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 Valores de configuración de Visual Studio.

De forma predeterminada, en Visual Studio se ha desactivado la compatibilidad en tiempo de diseño con los adaptadores de datos. Para la compatibilidad con los adaptadores de datos, debe agregarlos al Cuadro de herramientas, como se describe en el primer procedimiento siguiente.

Para agregar adaptadores de datos, conexiones y comandos al Cuadro de herramientas

Haga clic con el botón secundario del mouse en el Cuadro de herramientas y seleccione Elegir elementos.
Seleccione los elementos que desea agregar en la ficha Componentes de .NET Framework del cuadro de diálogo Elegir elementos del cuadro de herramientas. Por ejemplo, para utilizar el Proveedor de datos de .NET Framework para servidor SQL Server seleccione SqlDataAdapter, SqlConnection y SqlCommand.
Haga clic en Aceptar para agregar los elementos seleccionados al Cuadro de herramientas.

Para crear un adaptador de datos manualmente

Asegúrese de que haya un objeto de conexión disponible para el formulario o componente con el que está trabajando. Para obtener detalles sobre cómo agregar una conexión independiente, vea Establecer la conexión (ADO.NET).
En la ficha Datos del Cuadro de herramientas, arrastre un objeto OleDbDataAdapter, SqlDataAdapter, OdbcDataAdapter o OracleDataAdapter a la superficie de diseño.

El diseñador agrega una instancia del adaptador al formulario o componente e inicia el Asistente para la configuración del adaptador de datos.
Cierre el asistente.

Para configurar un adaptador de datos manualmente

Seleccione el adaptador y, a continuación, en la ventana Propiedades, configure los comandos que se utilizan para leer y actualizar datos. Debe configurar el objeto SelectCommand. Si el adaptador va a utilizarse para actualizar un origen de datos, deberá configurar los objetos UpdateCommand, DeleteCommand e InsertCommand.

Para cada objeto de comando, establezca las siguientes propiedades.

Propiedad	Descripción
ActiveConnection	Se establece para hacer referencia a un objeto de conexión. Puede crear un objeto de conexión desde la propiedad ActiveConnection de la ventana Propiedades. Habitualmente, cada objeto de comando hará referencia al mismo objeto de conexión, aunque existe la opción de utilizar conexiones diferentes para cada comando si la aplicación lo requiere.
CommandText	El texto de una instrucción SQL o el nombre de un procedimiento almacenado. Para algunos proveedores, es posible incluir múltiples instrucciones o nombres de procedimientos almacenados en la propiedad CommandText, delimitados por signos de punto y coma (;). Las instrucciones o procedimientos se ejecutan de forma secuencial. Esto resulta útil en situaciones tales como la emisión de una instrucción SELECT después de una instrucción UPDATE o INSERT, para recuperar registros actualizados y valores de generación automática (tales como valores predeterminados o de incremento automático).
CommandType	Un valor que indica cómo debe interpretarse el valor de la propiedad CommandText: Text: el comando es una instrucción SQL. StoredProcedure: el comando es una referencia a un procedimiento almacenado. TableDirect: el texto no es un comando, sino el nombre de una tabla.
Parameters	Una colección de objetos de tipo Parameter que se configura para pasar valores al comando. En el objeto SelectCommand, sólo deberá crear una colección de parámetros si el comando incluye un marcador de posición de parámetro. Los objetos UpdateCommand, InsertCommand y DeleteCommand siempre requieren parámetros. Para obtener información detallada, vea Cómo: Configurar parámetros para adaptadores de datos.

Si no desea tener los mismos nombres de columna en el origen de datos y en el conjunto de datos, cambie las asignaciones. El valor predeterminado de la propiedad MissingMappingAction, Passthrough, genera automáticamente los mismos nombres en el origen de datos y en el conjunto de datos. Para obtener más información, vea Cómo: Asignar columnas de orígenes de datos a columnas de tablas de datos del conjunto de datos.
Desde el menú Datos, elija Generar conjunto de datos.

Sugerencia:

Si no ve el menú Datos, haga clic con el mouse en cualquier punto del formulario o diseñador de componentes; el menú sólo aparece si el diseñador tiene el foco.
Si desea ver cómo llenará un adaptador de datos el conjunto de datos, abra una vista previa de los resultados. Para obtener más información, vea Cómo: Obtener una vista previa de los resultados del adaptador de datos.

Sugerencia:
Si no ve el menú Datos, haga clic con el mouse en cualquier punto del formulario o diseñador de componentes; el menú sólo aparece si el diseñador tiene el foco.