Adición de nuevos orígenes de datos en aplicaciones de ADO.NET (.NET Framework)

Nota:

Los conjuntos de datos y las clases relacionadas son tecnologías heredadas de .NET Framework de principios de la década de 2000 que permiten a las aplicaciones trabajar con datos en memoria mientras están desconectadas de la base de datos. Son especialmente útiles para las aplicaciones que permiten a los usuarios modificar los datos y conservar los cambios en la base de datos. Aunque los conjuntos de datos han demostrado ser una tecnología de gran éxito, se recomienda que las nuevas aplicaciones de .NET usen Entity Framework Core. Entity Framework proporciona una manera más natural de trabajar con datos tabulares como modelos de objetos y tiene una interfaz de programación más sencilla.

Nota

Las características descritas en este artículo se aplican al desarrollo de Windows Forms and WPF en .NET Framework. Las características no se admiten para el desarrollo de .NET Core, tanto para WPF como para Windows Forms.

En el contexto de las herramientas de datos de .NET en Visual Studio, el término origen de datos hace referencia a objetos de .NET que se conectan a un almacén de datos y hacen que los datos estén disponibles para una aplicación .NET. Los diseñadores de Visual Studio pueden consumir la salida del origen de datos para generar el código reutilizable que enlaza los datos a formularios al arrastrar y colocar objetos de base de datos desde la ventana Orígenes de datos. Este tipo de origen de datos puede ser:

• Una clase de un modelo de Entity Framework asociada a algún tipo de base de datos.

• Un conjunto de datos asociado a algún tipo de base de datos.

• Clase que representa un servicio de red como un servicio de datos de Windows Communication Foundation (WCF) o un servicio de REST.

• Clase que representa un servicio de SharePoint.

• Una clase o colección de la solución.

Nota

Si no usa características de enlace de datos, conjuntos de datos, Entity Framework, LINQ to SQL, WCF o SharePoint, no se aplica el concepto de "origen de datos". Solo tiene que conectarse directamente a la base de datos mediante los objetos SQLCommand y comunicarse directamente con la base de datos.

Puede crear y editar orígenes de datos mediante el Asistente para configuración de orígenes de datos en una aplicación de Windows Forms o Windows Presentation Foundation. En Entity Framework, cree primero las clases de entidad y, a continuación, inicie el asistente; para ello, seleccione Proyecto>Agregar nuevo origen de datos (como se describe con más detalle más adelante en este artículo).

Ventana de orígenes de datos

Después de crear un origen de datos, aparece en la ventana de herramientas Orígenes de datos.

Sugerencia

Para abrir la ventana Orígenes de datos, asegúrese de que el proyecto está abierto y, a continuación, presione Mayús+Alt+D o elija Ver>Otras ventanas>Orígenes de datos.

En un proyecto de Windows Forms que tenga como destino .NET Framework (no .NET Core ni .NET 5 o posterior), puede arrastrar un origen de datos desde la ventana Orígenes de datos a una superficie o control de diseño de formulario. Si arrastra una tabla, obtendrá BindingNavigator y DataGridView para la tabla. Si arrastra una columna individual, obtendrá los elementos BindingNavigator, Label y TextBox para esa columna. Arrastre las columnas para obtener un formulario completo de visualización de datos para una tabla. Estas acciones hacen que se genere código reutilizable que muestra los datos del almacén de datos.

En la ilustración siguiente se muestra un conjunto de datos que se ha colocado en un formulario de Windows Forms. Si selecciona F5 en la aplicación, los datos de la base de datos subyacente aparecerán en los controles del formulario.

Origen de datos para una base de datos o un archivo de base de datos

Puede crear un conjunto de datos o un modelo de Entity Framework para usarlo como un origen de datos para una base de datos o un archivo de base de datos.

Dataset

Para crear un conjunto de datos como origen de datos, ejecute el Asistente para configuración del origen de datos; para ello, seleccione Proyecto>Agregar nuevo origen de datos. Elija el tipo de origen de datos Base de datos y siga las indicaciones para especificar una conexión de base de datos nueva o existente o un archivo de base de datos.

Clases de entidad

Para crear un modelo de Entity Framework como origen de datos:

1. Ejecute el Asistente para Entity Data Model para crear las clases de entidad. Seleccione Proyecto>Agregar nuevo elemento>ADO.NET Entity Data Model.

   

2. Elija el método con el que desea generar el modelo.

   

3. Agregue el modelo como un origen de datos. Las clases generadas aparecen en el Asistente para configuración de orígenes de datos al elegir la categoría Objetos.

   

Origen de datos para un servicio

Para crear un origen de datos a partir de un servicio, ejecute el Asistente para configuración de orígenes de datos y elija el tipo de origen de datos Servicio. Esta acción es simplemente un acceso directo al cuadro de diálogo Agregar referencia de servicio, a la que también puede acceder haciendo clic con el botón derecho en el proyecto en Explorador de soluciones y seleccionando Agregar referencia de servicio.

Al crear un origen de datos a partir de un servicio, Visual Studio agrega una referencia de servicio al proyecto. Visual Studio también crea objetos proxy que corresponden a los objetos que el servicio devuelve. Por ejemplo, un servicio que devuelve un conjunto de datos se representa en el proyecto como un conjunto de datos; un servicio que devuelve un tipo específico se representa en el proyecto como el tipo devuelto.

Puede crear un origen de datos a partir de los siguientes tipos de servicios:

• Servicios de datos de WCF

• Servicios WCF

• servicios Web

  Nota

  Los elementos que aparecen en la ventana Orígenes de datos dependen de los datos devueltos por el servicio. Algunos servicios podrían no proporcionar suficiente información para que el Asistente para configuración de orígenes de datos pueda crear objetos enlazables. Por ejemplo, si el servicio devuelve un conjunto de datos sin tipo, en la ventana Orígenes de datos no aparece ningún elemento cuando el asistente se completa. Esto se debe a que los conjuntos de datos sin tipo no proporcionan un esquema y, por tanto, el asistente no tiene suficiente información para crear el origen de datos.

Origen de datos para un objeto

Puede crear un origen de datos a partir de cualquier objeto que exponga una o varias propiedades públicas mediante la ejecución del Asistente para configuración de orígenes de datos y con la selección posterior del tipo de origen de datos Objeto. Todas las propiedades públicas de un objeto se muestran en la ventana Orígenes de datos. Si usa Entity Framework y ha generado un modelo, aquí es donde se encuentran las clases de entidad que son los orígenes de datos de la aplicación.

En la página Seleccionar los objetos de datos, expanda los nodos de la vista de árbol para buscar los objetos a los que desea enlazar. La vista de árbol contiene nodos para el proyecto y para ensamblados y otros proyectos a los que hace referencia el proyecto.

Si desea enlazar a un objeto de un ensamblado o proyecto que no aparece en la vista de árbol, haga clic en Agregar referencia y use el cuadro de diálogo Agregar referencia para agregar una referencia al ensamblado o proyecto. Después de agregar la referencia, el ensamblado o proyecto se agrega a la vista de árbol.

Nota:

Puede que tenga que compilar el proyecto que contiene los objetos antes de que los objetos aparezcan en la vista de árbol.

Nota:

Para admitir el enlace de datos de arrastrar y colocar, los objetos que implementan la interfaz ITypedList o IListSource deben tener un constructor predeterminado. De lo contrario, Visual Studio no puede crear instancias del objeto de origen de datos y muestra un error al arrastrar el elemento a la superficie de diseño.

Origen de datos para una lista de SharePoint

Puede crear un origen de datos a partir de una lista de SharePoint; para ello, ejecute el Asistente para configuración de orígenes de datos y seleccione el tipo de origen de datos SharePoint. SharePoint expone datos a través de WCF Data Services, por lo que crear un origen de datos de SharePoint es lo mismo que crear un origen de datos desde un servicio. Al seleccionar el elemento SharePoint en el Asistente para configuración de orígenes de datos, se abre el cuadro de diálogo Agregar referencia de servicio, donde se conecta al servicio de datos de SharePoint apuntando al servidor de SharePoint. Esta acción requiere el SDK de SharePoint.

Contenido relacionado

• Visual Studio Data Tools para .NET