Crear un control de usuario de Windows Forms de .NET Framework que admita enlaces de datos complejos con ADO.NET

Al mostrar datos en formularios en aplicaciones de Windows, puede elegir los controles existentes en el Cuadro de herramientas. O bien, puede crear controles personalizados si la aplicación requiere funcionalidad que no está disponible en los controles estándar. En este tutorial se muestra cómo crear un control que implementeComplexBindingPropertiesAttribute. Los controles que implementan ComplexBindingPropertiesAttribute contienen una propiedad DataSource y una propiedad DataMember que se pueden vincular a datos. Estos controles son similares a un DataGridView o un ListBox.

Para obtener más información sobre la creación de controles, consulte Desarrollo de controles de Windows Forms en tiempo de diseño.

Al crear controles para su uso en escenarios de enlace de datos, debe implementar uno de los siguientes atributos de enlace de datos:

En este tutorial se crea un control complejo que muestra filas de datos de una tabla. En este ejemplo se usa la tabla Customers de la base de datos de ejemplo Northwind. El control de usuario complejo mostrará la tabla de clientes en una DataGridView del control personalizado.

Durante este tutorial, aprenderá a:

• Agregue un nuevo control de usuario al proyecto.

• Diseñe visualmente el control de usuario.

• Implemente el ComplexBindingProperty atributo .

• Cree un conjunto de datos con el Asistente para configuración del origen de datos.

• Establezca la tabla Customers en la ventana Orígenes de datos para usar el nuevo control complejo.

• Agregue el nuevo control arrastrándolo desde la ventana Orígenes de datos a Form1.

Prerrequisitos

Para completar este tutorial, necesita las cargas de trabajo de desarrollo de escritorio de .NET y almacenamiento y procesamiento de datos instaladas en Visual Studio. Para instalarlos, abra el Visual Studio Installer y elija Modificar (o Más>Modificar) junto a la versión de Visual Studio que desea modificar. Vea Modificación de Visual Studio.

En este tutorial se usa SQL Server Express LocalDB y la base de datos de ejemplo Northwind.

1. Si no tiene SQL Server Express LocalDB, instálelo desde la página de descarga de SQL Server Express o mediante el Instalador de Visual Studio. En el instalador de Visual Studio , puede instalar SQL Server Express LocalDB como parte de la carga de trabajo de almacenamiento y procesamiento de datos , o como componente individual.

2. Instale la base de datos de ejemplo Northwind siguiendo estos pasos:

   1. En Visual Studio, abra la ventana Explorador de objetos de SQL Server (El Explorador de objetos de SQL Server se instala como parte de la carga de trabajo Almacenamiento y procesamiento de datos en el Instalador de Visual Studio). Expanda el nodo SQL Server . Haga clic con el botón derecho en la instancia de LocalDB y seleccione Nueva consulta.

      Se abre una ventana del editor de consultas.

   2. Copie el script Northwind Transact-SQL en su Portapapeles. Este script de T-SQL crea la base de datos Northwind desde cero y la rellena con datos.

   3. Pegue el script T-SQL en el editor de consultas y, a continuación, elija el botón Ejecutar.

      Después de un breve tiempo, la consulta finaliza la ejecución y se crea la base de datos Northwind.

Creación de un proyecto de aplicación de Windows Forms

El primer paso es crear un proyecto de aplicación de Windows Forms para C# o Visual Basic. Asigne al proyecto el nombre ComplexControlWalkthrough.

Adición de un control de usuario al proyecto

Dado que este tutorial crea un control complejo enlazable a datos desde un control de usuario, agregue un elemento Control de usuario al proyecto:

1. En el menú Proyecto , elija Agregar control de usuario.

2. Escriba ComplexDataGridView en el área Nombre y, a continuación, seleccione Agregar.

   El control ComplexDataGridView se agrega al Explorador de soluciones y se abre en el diseñador.

Diseño del control ComplexDataGridView

Para agregar un DataGridView elemento al control de usuario, arrastre un DataGridView elemento desde el Cuadro de herramientas a la superficie de diseño del control de usuario.

Adición del atributo de enlace de datos necesario

Para controles complejos que admiten el enlace de datos, puede implementar :ComplexBindingPropertiesAttribute

1. Cambie el control ComplexDataGridView a la vista de código. (En el menú Ver , seleccione Código).

2. Reemplace el código en ComplexDataGridView con lo siguiente:

   • C#
   • VB

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
       public partial class ComplexDataGridView : UserControl
       {
           public object DataSource
           {
               get{ return dataGridView1.DataSource; }
               set{ dataGridView1.DataSource = value; }
           }
   
           public string DataMember
           {
               get{ return dataGridView1.DataMember; }
               set{ dataGridView1.DataMember = value; }
           }
   
           public ComplexDataGridView()
           {
               InitializeComponent();
           }
       }
   }
   

3. En el menú Compilar , elija Compilar solución.

Creación de un origen de datos a partir de la base de datos

Utilice el Asistente de Configuración del Origen de Datos para crear un origen de datos basado en la tabla Customers en la base de datos de ejemplo Northwind:

1. Para abrir la ventana Orígenes de datos , en el menú Datos , haga clic en Mostrar orígenes de datos.

2. En la ventana Orígenes de datos , seleccione Agregar nuevo origen de datos para iniciar el Asistente para configuración del origen de datos .

3. Seleccione Base de datos en la página Elegir un tipo de origen de datos y, a continuación, seleccione Siguiente.

4. En la página Elegir la conexión de datos , realice una de las acciones siguientes:

   • Si hay disponible una conexión de datos a la base de datos de ejemplo Northwind en la lista desplegable, selecciónela.

   • Seleccione Nueva conexión para iniciar el cuadro de diálogo Agregar o modificar conexión .

5. Si la base de datos requiere una contraseña, seleccione la opción para incluir datos confidenciales y, a continuación, seleccione Siguiente.

6. En la página Guardar cadena de conexión en el archivo de configuración de la aplicación , haga clic en Siguiente.

7. En la página Elegir los objetos de base de datos , expanda el nodo Tablas .

8. Seleccione la Customers tabla y, a continuación, seleccione Finalizar.

   NorthwindDataSet se agrega al proyecto y la Customers tabla aparece en la ventana Orígenes de datos.

Establecer la tabla Customers para usar el control ComplexDataGridView

En la ventana Orígenes de datos , puede establecer el control que se va a crear antes de arrastrar elementos al formulario:

1. Abra Form1 en el diseñador.

2. Expanda el nodo Clientes en la ventana Orígenes de datos .

3. Haga clic en la flecha de lista desplegable del nodo Clientes y elija Personalizar.

4. Seleccione ComplexDataGridView en la lista de controles asociados en el cuadro de diálogo Opciones de personalización de la interfaz de usuario de datos .

5. Haga clic en la flecha de lista desplegable de la Customers tabla y elija ComplexDataGridView en la lista de controles.

Adición de controles al formulario

Puede crear los controles enlazados a datos arrastrando elementos desde la ventana Orígenes de datos al formulario. Arrastre el nodo Clientes principal desde la ventana Orígenes de datos hasta el formulario. Compruebe que el control ComplexDataGridView se usa para mostrar los datos de la tabla.

Ejecutar la aplicación

Presione F5 para ejecutar la aplicación.

Pasos siguientes

En función de los requisitos de la aplicación, es posible que desee realizar varios pasos después de crear un control que admita el enlace de datos. Algunos pasos siguientes típicos son:

• Colocar los controles personalizados en una biblioteca de controles para poder reutilizarlos en otras aplicaciones.

• Crear controles que admitan escenarios de búsqueda. Para más información, consulte Creación de un control de usuario de Windows Forms que admita el enlace de datos de búsqueda.

Contenido relacionado

• Enlace de controles de Windows Forms a datos en Visual Studio
• Establezca el control que se va a crear al arrastrar desde la ventana Orígenes de datos.
• Controles de Formularios Windows Forms