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

Neste tutorial, aprende a usar o Visual Studio para criar uma aplicação Windows Forms. O Visual Studio disponibiliza um designer visual para adicionar controlos e gerir 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 desktop .NET
  • Selecione o componente individual .NET 10

Criar uma aplicação Windows Forms

O primeiro passo para criar uma nova aplicação é abrir o Visual Studio e gerar a aplicação a partir de um modelo.

1. Abre 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. No menu suspenso linguagem de código, escolha C# ou Visual Basic.

5. Na lista de modelos, selecione Windows Forms App e depois selecione Next.

   Importante

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

   A imagem seguinte mostra os modelos de projetos em 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 Informação adicional, selecione .NET 10.0 (Suporte a Longo Prazo) para a definição Framework, e depois selecione Criar.

   

Depois de Visual Studio gerar a aplicação, abre a janela de designer para o formulário predefinido, Form1. Se o designer do formulário não estiver visível, clique duas vezes no formulário na janela Explorador 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 Toolbox e Propriedades. O Visual Studio lembra-se de quando abres estas janelas e mantém-nas abertas no futuro.

Para abrir as janelas:

1. Selecione a opção VerCaixa de Ferramentas.
2. Selecione o menu VerPropriedades.

Partes importantes do Visual Studio

O suporte para Windows Forms no Visual Studio tem quatro componentes importantes com os quais interage ao criar uma aplicação:

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 de 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
• Caixa de Listagem
• 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 textbox à 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 :

   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 DebugStart 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 um aplicativo Windows Forms para .NET no Visual Studio 2026.

Conteúdo relacionado

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