Tutorial: Crie uma aplicação Windows Forms usando .NET

Neste tutorial, você aprenderá a usar o Visual Studio para criar um aplicativo do Windows Forms. Ao usar o Visual Studio, adiciona controlos a um formulário e gere eventos. No final deste tutorial, você tem um aplicativo simples que adiciona nomes a uma caixa de listagem.

Neste tutorial, você:

Pré-requisitos

• Visual Studio 2026
  • Selecione a carga de trabalho de desenvolvimento de aplicações de ambiente de trabalho .NET
  • Selecione o componente individual .NET 10

Criar um aplicativo do Windows Forms

A primeira etapa para criar um novo aplicativo é abrir o Visual Studio e gerar o aplicativo a partir de um modelo.

1. Abra o Visual Studio.

2. Selecione Criar um novo projeto.

   

3. Na caixa de pesquisa para modelos, digite winformse aguarde até que os resultados da pesquisa apareçam.

4. Na lista suspensa de código , escolha C# ou Visual Basic .

5. Na lista de modelos, selecione Windows Forms App e depois selecione Avançar.

   Importante

   Não selecione o template Windows Forms App (.NET Framework).

   A imagem a seguir mostra modelos de projeto C# e Visual Basic .NET. Se aplicou o filtro de linguagem de código , o modelo correspondente está listado.

   

6. Na janela Configurar o seu novo projeto, defina o Nome do projeto como Nomes e selecione Seguinte.

   Você também pode salvar seu projeto em uma pasta diferente, ajustando o Local caminho.

   

7. Finalmente, na janela de informação adicional , selecione .NET 10.0 (Suporte a Longo Prazo) para a definição Framework e depois selecione Criar.

   

Depois de o Visual Studio gerar a aplicação, abre a janela de designer para o formulário padrão, Form1. Se o designer de formulário não estiver visível, clique duas vezes no formulário na janela Gerenciador de Soluções para abrir a janela do designer.

Ativar as janelas da Toolbox e das Propriedades

Por defeito, o Visual Studio não abre as janelas de Toolbox e Propriedades. O Visual Studio lembra-se que abriste essas janelas e mantém-nas abertas no futuro.

Para abrir as janelas:

1. Selecione a opção Ver>Caixa de Ferramentas.
2. Selecione o menu Ver>Propriedades.

Partes importantes do Visual Studio

O suporte para Windows Forms no Visual Studio tem quatro componentes importantes com os quais você interage ao criar um aplicativo:

1. Explorador de Soluções

   Todos os teus ficheiros de projeto, código, formulários e recursos aparecem nesta janela.

2. Propriedades

   Esta janela mostra as configurações de propriedade que você pode configurar com base no contexto do item selecionado. Por exemplo, se selecionares um item no Explorador de Soluções, vês as definições relacionadas com o ficheiro. Se selecionares um objeto no Designer, vês as propriedades do controlo ou do formulário.

3. Designer de Formulários

   Este é o designer para o formulário. É interativo e podes arrastar e largar objetos a partir da Toolbox. Ao selecionar e mover itens no designer, você pode compor visualmente a interface do usuário (UI) para seu aplicativo.

4. Caixa de ferramentas

   A caixa de ferramentas contém todos os controles que você pode adicionar a um formulário. Para adicionar um controlo ao formulário atual, clique duas vezes num controlo ou arraste-o e solte no formulário.

Adicionar controles ao formulário

Com o Form1 designer de formulário aberto, use a janela Toolbox para adicionar os seguintes controles ao formulário arrastando-os da caixa de ferramentas e soltando-os no formulário:

• Botão
• Etiqueta
• ListBox
• Caixa de texto

Posicione e dimensione os controles de acordo com a seguinte imagem:

Você pode mover e redimensionar os controles com o mouse para corresponder à imagem anterior ou usar a tabela a seguir para configurar cada controle. Para configurar um controle, selecione-o no designer e defina a configuração apropriada na janela Propriedades . Ao configurar o formulário, selecione a barra de título do formulário.

Gerir eventos

Depois de organizares todos os controlos no formulário, adiciona manipuladores de eventos para responder ao input do utilizador. Vá para o designer de formulário e execute as seguintes etapas:

1. Selecione o botão de controlo Adicionar Nome no formulário.

2. Na janela de Propriedades , selecione o ícone de eventos para listar os eventos do botão.

3. Encontre o evento Click e clique duas vezes nele para gerar um manipulador de eventos.

   Esta ação adiciona o seguinte código ao formulário:

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

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

   O código deste handler adiciona o nome especificado pela txtName textbox à lstNames listbox. No entanto, queres adicionar duas condições para adicionar o nome: o nome não pode estar em branco, e o nome não pode já existir.

4. O código a seguir demonstra a adição de um nome para o controle 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
   

Executar o aplicativo

Depois de tratar do evento, executa a aplicação pressionando a tecla F5 ou selecionando Debug>Start Debugging no menu. Quando a aplicação inicia, o formulário é exibido. Introduza um nome na caixa de texto e selecione o botão.

Executar uma aplicação Windows Forms para .NET no Visual Studio 2026.

Conteúdo relacionado

• Saiba mais sobre o Windows Forms
• Visão geral do uso de controles
• Visão geral de eventos