Tutorial: Crear un control de usuario de Windows Forms que admita el enlace de datos complejo

Artículo
06/10/2015

Cuando muestra datos en formularios de las aplicaciones Windows, puede elegir controles existentes en el Cuadro de herramientas o 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 implementa ComplexBindingPropertiesAttribute. Los controles que implementan ComplexBindingPropertiesAttribute contienen unas propiedades DataSource y DataMember que se pueden enlazar a datos. Tales controles son similares a DataGridView o ListBox.

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

Al crear controles para el uso en escenarios de enlace de datos, necesita implementar uno de los atributos de enlace a datos siguientes:

Uso de atributo de enlace de datos
Implemente el DefaultBindingPropertyAttribute en controles sencillos, como un TextBox, que muestra una única columna (o propiedad) de datos. Para obtener más información, vea Tutorial: Crear un control de usuario de Windows Forms que admita el enlace de datos simple.
Implemente el ComplexBindingPropertiesAttribute en controles, como DataGridView, que muestra listas (o tablas) de datos. (Este proceso se describe en esta página del tutorial.)
Implemente el LookupBindingPropertiesAttribute en controles, como ComboBox, que muestren listas (o tablas) de datos, pero que también necesiten presentar una única columna o propiedad. Para obtener más información, vea Tutorial: Crear un control de usuario de Windows Forms que admita el enlace de datos de búsqueda.

En este tutorial se crea un control complejo que muestra las filas de datos de una tabla. En este ejemplo se utiliza 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:

Crear una nueva aplicación para Windows.
Agregue un nuevo Control de usuario a su proyecto.
Diseñe visualmente el control de usuario.
Implemente el atributo ComplexBindingProperty.
Cree un conjunto de datos con el Asistente para la configuración de orígenes de datos.
Establezca la tabla Customers de la Orígenes de datos (ventana) de forma que se use el nuevo control complejo.
Agregue el nuevo control arrastrándolo desde la ventana Orígenes de datos hasta Form1.

Requisitos previos

Para poder completar este tutorial, necesitará:

Acceso a la base de datos de ejemplo Northwind. Para obtener más información, vea Cómo: Instalar bases de datos de ejemplo.

Crear una aplicación para Windows

El primer paso es crear una Aplicación para Windows.

Para crear el nuevo proyecto de Windows

En Visual Studio, en el menú Archivo cree un nuevo Proyecto.
Asigne el nombre TutorialDeControlComplejo al proyecto.
Seleccione Aplicación para Windows y haga clic en Aceptar. Para obtener más información, vea Desarrollar aplicaciones cliente con .NET Framework.

El proyecto TutorialDeControlComplejo se crea y se agrega al Explorador de soluciones.

Agregar un control de usuario al proyecto

Como en este tutorial se crea un control complejo enlazable a datos a partir de un Control de usuario, deberá agregar un elemento Control de usuario al proyecto.

Para agregar un control de usuario al proyecto

En el menú Proyecto, elija Agregar control de usuario.
Escriba ComplexDataGridView en el área Nombre y haga clic en Agregar.

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

Diseñar el control ComplexDataGridView

En este paso se agrega un DataGridView al control de usuario.

Para diseñar el control ComplexDataGridView

Arrastre un control DataGridView del Cuadro de herramientas hasta la superficie de diseño del control del usuario.

Agregar el atributo de enlace de datos requerido

En el caso de los controles complejos que admiten enlaces a datos, puede implementar el ComplexBindingPropertiesAttribute.

Para implementar el atributo ComplexBindingProperties

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

Reemplace el código de ComplexDataGridView por lo siguiente:

<System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>
Public Class ComplexDataGridView

    Public Property DataSource() As Object 
        Get 
            Return DataGridView1.DataSource
        End Get 
        Set(ByVal value As Object)
            DataGridView1.DataSource = value
        End Set 
    End Property 

    Public Property DataMember() As String 
        Get 
            Return DataGridView1.DataMember
        End Get 
        Set(ByVal value As String)
            DataGridView1.DataMember = value
        End Set 
    End Property 
End Class

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();
        }
    }
}

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

Crear un origen de datos de su base de datos

En este paso se usa el Asistente para la configuración de orígenes de datos para crear un origen de datos basado en la tabla Customers de la base de datos de ejemplo Northwind. Debe tener acceso a la base de datos de ejemplo Northwind para crear la conexión. Para obtener información sobre la configuración de la base de datos de ejemplo Northwind, vea Cómo: Instalar bases de datos de ejemplo.

Para crear el origen de datos

En el menú Datos, haga clic en Mostrar orígenes de datos.
En la ventana Orígenes de datos, seleccione Agregar nuevo origen de datos para iniciar el Asistente para configuración de orígenes de datos.
Seleccione Base de datos en la página Elegir un tipo de datos de origen y luego haga clic en Siguiente.
En la página Elegir la conexión de datos realice una de las siguientes operaciones:
- Si una conexión de datos a la base de datos de ejemplo Northwind está disponible en la lista desplegable, selecciónela.
  
  O bien
- Seleccione Nueva conexión para iniciar el cuadro de diálogo Agregar o modificar conexión.
Si su base de datos requiere una contraseña, seleccione la opción para incluir datos confidenciales y haga clic en Siguiente.
Haga clic en Siguiente en la página Guardar la cadena de conexión en el archivo de configuración de la aplicación.
Expanda el nodo Tables en la página Elija los objetos de base de datos.
Seleccione la tabla Customers y, a continuación, haga clic en Finalizar.

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

Establecer la columna Customers para que use el control ComplexDataGridView

Dentro de la ventana Orígenes de datos puede establecer el control que se va a crear antes de arrastrar elementos a un formulario.

Para establecer la columna Customers para enlazarse al control ComplexDataGridView

Abra Form1 en el diseñador.
Expanda el nodo Customers en la ventana Orígenes de datos.
Haga clic en la flecha de lista desplegable en la columna Customers y elija Personalizar.
Seleccione ComplexDataGridView de la lista de Controles asociados en el cuadro de diálogo Opciones de personalización de la interfaz de usuario de datos.
Haga clic en la flecha de lista desplegable en la tabla Customers y elija ComplexDataGridView de la lista de controles.

Agregar controles al formulario

Puede crear los controles enlazados a datos arrastrando elementos desde la ventana Orígenes de datos al formulario.

Para crear controles enlazados en el formulario

Arrastre el nodo principal Customers desde la ventana Orígenes de datos al formulario y compruebe que se usa el control ComplexDataGridView para mostrar los datos de la tabla.

Ejecutar la aplicación

Para ejecutar la aplicación

Presione F5 para ejecutar la aplicación.

Pasos siguientes

Según cuáles sean los requisitos de la aplicación, hay varios pasos que se pueden realizar después de crear un control que admite el enlace a datos. Entre los pasos más habituales están los siguientes:

Colocar los controles personalizados en una biblioteca de controles para poder reutilizarlos en otras aplicaciones.
Crear controles que admitan escenarios de búsqueda. Para obtener más información, vea Tutorial: Crear un control de usuario de Windows Forms que admita el enlace de datos de búsqueda.

Vea también

Compartir a través de