Compartir a través de


Información general sobre el control de usuario (Windows Forms para .NET)

Un control de usuario es una colección de controles de Windows Forms encapsulados en un contenedor común. Este tipo de control se conoce como un control compuesto. Los controles contenidos se denominan controles constituyentes. Los controles de usuario derivan de la clase UserControl.

Los controles de usuario están diseñados como Formularios, con un diseñador visual. Los controles constituyentes se crean, organizan y modifican mediante el diseñador visual. Los eventos de control y la lógica se escriben exactamente de la misma manera que cuando se diseña un formulario. El control de usuario se coloca en un formulario como cualquier otro control.

Los controles de usuario pueden usarse por el proyecto en el que se crean o en otros proyectos que tienen referencia a la biblioteca del control de usuario.

Importante

La documentación de la guía de escritorio para .NET 7 y .NET 6 está en proceso de elaboración.

Controles constituyentes

Los controles constituyentes están disponibles para el control de usuario y el usuario de la aplicación puede interactuar con ellos todos individualmente en runtime, pero las propiedades y los métodos declarados por los controles constituyentes no se exponen al consumidor. Por ejemplo, si coloca un control de TextBox y Button en el control de usuario, el control de usuario controla internamente el evento Click del botón, pero no por el formulario donde se coloca el control de usuario.

Agregar un control de usuario al proyecto

Después de crear un proyecto, use las plantillas de Visual Studio para crear un control de usuario. En los pasos siguientes se muestra cómo agregar un control de usuario al proyecto:

  1. En Visual Studio, busque el panel Explorador de proyectos. Haga clic con el botón derecho en el proyecto y seleccione Agregar>Control de usuario (Windows Forms).

    Haga clic con el botón derecho en el Explorador de soluciones de Visual Studio para agregar un control de usuario a un proyecto de Windows Forms

  2. En el cuadro Nombre, escriba un nombre para el control de usuario. Visual Studio proporciona un nombre predeterminado y único que puede usar. A continuación, presione Agregar.

    Cuadro de diálogo Agregar elemento en Visual Studio para Windows Forms

Una vez creado el control de usuario, Visual Studio abre el diseñador:

Diseñador de controles de usuario en Visual Studio para Windows Forms

Para obtener un ejemplo de un control de usuario en funcionamiento, vea Creación de un control de usuario.