Tutorial: Criar um aplicativo Windows Forms usando .NET

Neste tutorial, você aprenderá a usar Visual Studio para criar um aplicativo Windows Forms. Visual Studio fornece um designer visual para você adicionar controles e manipular eventos. Ao 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 desktop .NET
  • Selecione o componente individual .NET 10

Criar um aplicativo Windows Forms

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

1. Abra Visual Studio.

2. Selecione Criar um novo projeto.

   

3. Na caixa Pesquisar modelos , digite winforms e aguarde a exibição dos resultados da pesquisa.

4. Na lista suspensa code, escolha C# ou Visual Basic.

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

   Importante

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

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

   

6. Na janela Configurar seu novo projeto , defina o nome do projeto como Nomes e selecione Avançar.

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

   

7. Por fim, na janela Additional, selecione .NET 10.0 (Suporte de Longo Prazo) para a configuração Framework e selecione Create.

   

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

Habilitar as janelas Caixa de Ferramentas e Propriedades

Por padrão, Visual Studio não abre as janelas Caixa de Ferramentas e Propriedades. Visual Studio lembra quando você abre essas janelas e as mantém abertas no futuro.

Para abrir as janelas:

1. Selecione o item de menu ExibirCaixa de Ferramentas .
2. Selecione o item de menu ExibirPropriedades da Janela .

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. Gerenciador de Soluções

   Todos os arquivos 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 você selecionar um item de Gerenciador de Soluções, verá as configurações relacionadas ao arquivo. Se você selecionar um objeto no Designer, verá as propriedades do controle ou formulário.

3. Designer de Formulários

   Este é o designer do formulário. Ele é interativo e você pode arrastar e soltar objetos da Caixa de Ferramentas. Selecionando e movendo itens no designer, você pode compor visualmente a interface do usuário (interface do usuário) 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 controle ao formulário atual, clique duas vezes em um controle ou arraste e solte o controle no formulário.

Adicionar controles ao formulário

Com o designer de formulários Form1 aberto, use a janela Caixa de Ferramentas 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 imagem a seguir:

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.

Manipular eventos

Depois de definir todos os controles no formulário, adicione manipuladores de eventos para responder à entrada do usuário. Vá para o designer de formulários e execute as seguintes etapas:

1. Selecione o controle do botão Adicionar Nome no formulário.

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

3. Localize o evento Clique e clique duas vezes nele para gerar um manipulador de eventos.

   Essa 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 desse manipulador adiciona o nome especificado pela caixa de texto à caixa de listagem. No entanto, você deseja adicionar duas condições para adicionar o nome: o nome não pode estar em branco e o nome ainda não pode existir.

4. O código a seguir demonstra a adição de um nome ao 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 manipular o evento, execute o aplicativo pressionando a tecla F5 ou selecionando DepurarIniciar Depuração no menu. Quando o aplicativo é iniciado, o formulário é exibido. Insira um nome na caixa de texto e selecione o botão.

Conteúdo relacionado

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