Tutorial: Creación de una aplicación Windows Forms con .NET

En este tutorial, aprenderá a usar Visual Studio para crear una nueva aplicación de Windows Forms. Con Visual Studio, agregará controles a un formulario y controlará eventos. Al final de este tutorial, tiene una aplicación sencilla que agrega nombres a un cuadro de lista.

En este tutorial ha:

• Creación de una nueva aplicación Windows Forms
• Agregar controles a un formulario
• Controlar los eventos de control para proporcionar la funcionalidad de la aplicación
• Ejecución la aplicación

Requisitos previos

• Visual Studio 2022, versión 17.12 o versiones posteriores
  • Selección de la carga de trabajo de desarrollo para el escritorio de .NET
  • Selección del componente individual de .NET 9

Crear una aplicación de Windows Forms

El primer paso para crear una aplicación consiste en abrir Visual Studio y generar la aplicación a partir de una plantilla.

1. Abra Visual Studio.

2. Seleccione Crear un proyecto.

   

3. En el cuadro Buscar plantillas escriba winforms y espere a que aparezcan los resultados de la búsqueda.

4. En la lista desplegable Lenguaje de código, elija C# o Visual Basic.

5. En la lista de plantillas, seleccione Aplicación de Windows Forms y, a continuación, seleccione Siguiente.

   Importante

   No seleccione la plantilla Aplicación de Windows Forms (.NET Framework) .

   En la imagen siguiente se muestran plantillas de proyecto, tanto para C#, como para Visual Basic de .NET. Si ha aplicado el filtro de lenguaje de código, se muestra la plantilla correspondiente.

   

6. En la ventana Configurar el nuevo proyecto, establezca el nombre del proyecto en Nombres y seleccione Siguiente.

   También puede guardar el proyecto en otra carpeta ajustando la ruta de acceso de la Ubicación.

   

7. Por último, en la ventana Información adicional, seleccione .NET 9.0 (Compatibilidad con términos estándar) para la configuración de Framework y, a continuación, seleccione Crear.

   

Una vez generada la aplicación, Visual Studio debe abrir la ventana del diseñador para el formulario predeterminado, Form1. Si el diseñador de formularios no está visible, haga doble clic en el formulario en la ventana Explorador de soluciones para abrir la ventana del diseñador.

Elementos importantes de Visual Studio

La compatibilidad con Windows Forms en Visual Studio tiene cuatro componentes importantes con los que interactúa a medida que crea una aplicación:

1. Explorador de soluciones

   Todos los archivos del proyecto, código, formularios, recursos, aparecen en esta ventana.

2. Propiedades

   En esta ventana se muestran los valores de propiedad que puede configurar en función del contexto del elemento seleccionado. Por ejemplo, si selecciona un elemento de Explorador de soluciones, se muestran los valores relacionados con el archivo. Si se selecciona el objeto en el Diseñador , se muestran las propiedades del control o formulario.

3. Diseñador de formularios

   Este es el diseñador para el formulario. Es interactivo y puede arrastrar y colocar objetos desde el Cuadro de herramientas. Al seleccionar y mover elementos en el diseñador, puede crear visualmente la interfaz de usuario (IU) de la aplicación.

4. Cuadro de herramientas

   El Cuadro de herramientas contiene todos los controles que se pueden agregar a un formulario. Para agregar un control al formulario actual, haga doble clic en un control, o bien arrástrelo y colóquelo.

Sugerencia

Si no aparece el cuadro de herramientas, puede mostrarlo a través del elemento de menú Ver>Cuadro de herramientas.

Adición de controles al formulario

Con el diseñador de formularios Form1 abierto, use la ventana Cuadro de herramientas para agregar los siguientes controles al formulario arrastrándolos desde el cuadro de herramientas y colocandolos en el formulario:

• Botón
• Label
• Listbox
• Cuadro de texto

Posición y tamaño de los controles según la siguiente imagen:

Puede mover y cambiar el tamaño de los controles con el mouse para que coincida con la imagen anterior o usar la tabla siguiente para configurar cada control. Para configurar un control, selecciónelo en el diseñador y, a continuación, establezca el valor adecuado en la ventana Propiedades . Al configurar el formulario, seleccione la barra de título del formulario.

Object	Configuración	Valor
Etiqueta	Ubicación	12, 9
	Texto	Names
Listbox	Nombre	lstNames
	Ubicación	12, 27
	Tamaño	120, 94
Cuadro de texto	Nombre	txtName
	Ubicación	138, 26
	Tamaño	100, 23
Button	Nombre	btnAdd
	Ubicación	138, 55
	Tamaño	100, 23
	Texto	Add Name
Forma	Texto	Names
	Size	268, 180

Control de eventos

Ahora que el formulario tiene todos sus controles establecidos, el siguiente paso es agregar controladores de eventos para responder a la entrada del usuario. Vaya al diseñador de formularios y realice los pasos siguientes:

1. Seleccione el control de botón Agregar nombre en el formulario.

2. En la ventana Propiedades , seleccione el icono de eventos para enumerar los eventos del botón.

3. Busque el evento Click y haga doble clic en él para generar un controlador de eventos.

   Esta acción agrega el código siguiente al formulario:

   private void btnAdd_Click(object sender, EventArgs e)
   {
   
   }
   

   Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
   
   End Sub
   

   El código de este controlador va a agregar el nombre especificado por el txtName cuadro de texto al cuadro de lstNames lista. Pero quiere que para agregar el nombre se cumplan dos condiciones: el nombre proporcionado no debe estar en blanco y no debe existir todavía.

4. En el código siguiente se muestra cómo agregar un nombre al control lstNames:

   private void btnAdd_Click(object sender, EventArgs e)
   {
       if (!string.IsNullOrWhiteSpace(txtName.Text) && !lstNames.Items.Contains(txtName.Text))
           lstNames.Items.Add(txtName.Text);
   }
   

   Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
       If Not String.IsNullOrWhiteSpace(txtName.Text) And Not lstNames.Items.Contains(txtName.Text) Then
           lstNames.Items.Add(txtName.Text)
       End If
   End Sub
   

Ejecución de la aplicación

Ahora que el evento se controla, ejecute la aplicación presionando la tecla F5 o seleccionando Depurar Iniciar depuración> en el menú. Cuando se inicia la aplicación, se muestra el formulario y puede escribir un nombre en el cuadro de texto y seleccionar el botón.

Contenido relacionado

• Más información sobre Windows Forms
• Información general sobre el uso de controles
• Introducción a los eventos