Criar um aplicativo do Windows Forms no Visual Studio com C#

  • Artigo

Neste tutorial, você criará um aplicativo simples do C# que tem uma interface do usuário baseada em Windows.

Se você ainda não tiver instalado o Visual Studio, acesse a página Downloads do Visual Studio para instalá-lo gratuitamente.

Observação

Algumas das capturas de tela neste tutorial usam o tema escuro. Se você não estiver usando o tema escuro, mas quiser usá-lo, confira a página Personalizar o IDE e o Editor do Visual Studio para saber como.

Se você ainda não tiver instalado o Visual Studio, acesse a página Downloads do Visual Studio 2022 para instalá-lo gratuitamente.

Criar um projeto

Primeiro, você criará um projeto de aplicativo em C#. O tipo de projeto inclui todos os arquivos de modelo que você precisará, mesmo sem adicionar nada.

  1. Abra o Visual Studio.

  2. Na tela Iniciar, selecione Criar um novo projeto.

    View the 'Create a new project' window

  3. Na janela Criar um novo projeto, escolha o modelo Aplicativo do Windows Forms (.NET Framework) para C#.

    (Se preferir, você pode refinar sua pesquisa para acessar rapidamente o modelo desejado. Por exemplo, insira ou digite Aplicativo do Windows Forms na caixa de pesquisa. Em seguida, escolha C# na lista Linguagem e escolha Windows na lista Plataforma.)

    Choose the C# template for the Windows Forms App (.NET Framework)

    Observação

    Se você não encontrar o modelo do Aplicativo do Windows Forms (.NET Framework), poderá instalá-lo a partir da janela Criar um novo projeto. Na mensagem Não encontrou o que precisa?, escolha o link Instalar mais ferramentas e recursos.

    The 'Install more tools and features' link from the 'Not finding what you're looking for' message in the 'Create new project' window

    Em seguida, no Instalador do Visual Studio, escolha a carga de trabalho Desenvolvimento de desktop do .NET.

    .NET Core workload in the Visual Studio Installer

    Depois disso, escolha o botão Modificar no Instalador do Visual Studio. Pode ser solicitado que você salve seu trabalho; nesse caso, faça isso. Em seguida, escolha Continuar para instalar a carga de trabalho. Em seguida, retorne para a etapa 2 deste procedimento para "Criar um projeto".

  4. Na janela Configurar seu novo projeto, digite ou insira OláMundo na caixa Nome do projeto. Em seguida, escolha Criar.

    in the 'Configure your new project' window, name your project 'HelloWorld'

    O Visual Studio abre seu novo projeto.

  1. Abra o Visual Studio.

  2. Na janela inicial, selecione Criar um novo projeto.

    Screenshot to show the Create a new project window.

  3. Na janela Criar um novo projeto, selecione o modelo Aplicativo do Windows Forms (.NET Framework) para C#.

    (Se preferir, você pode refinar sua pesquisa para acessar rapidamente o modelo desejado. Por exemplo, insira ou digite Aplicativo do Windows Forms na caixa de pesquisa. Em seguida, selecione C# na lista Linguagem e selecione Windows na lista Plataforma.)

    Screenshot to select the C# template for the Windows Forms App (.NET Framework).

    Observação

    Se você não encontrar o modelo do Aplicativo do Windows Forms (.NET Framework), poderá instalá-lo a partir da janela Criar um novo projeto. Na mensagem Não encontrou o que precisa?, selecione o link Instalar mais ferramentas e recursos.

    Screenshot to show the The 'Install more tools and features' link from the 'Not finding what you're looking for' message in the 'Create a new project' window.

    Em seguida, no Instalador do Visual Studio, selecione a carga de trabalho Desenvolvimento de desktop do .NET.

    Screenshot to show the .NET Core workload in the Visual Studio Installer.

    Depois disso, selecione o botão Modificar no Instalador do Visual Studio. Pode ser solicitado que você salve seu trabalho; nesse caso, faça isso. Em seguida, selecione Continuar para instalar a carga de trabalho. Em seguida, retorne para a etapa 2 deste procedimento para "Criar um projeto".

  4. Na janela Configurar seu novo projeto, digite ou insira OláMundo na caixa Nome do projeto. Em seguida, selecione Criar.

    Screenshot to show the 'Configure your new project' window and name your project 'HelloWorld'.

    O Visual Studio abre seu novo projeto.

Criar o aplicativo

Depois de selecionar o seu modelo de projeto do C# e nomear seu arquivo, o Visual Studio abrirá um formulário para você. Um formulário é uma interface do usuário do Windows. Vamos criar um aplicativo "Olá, Mundo" ao adicionar controles ao formulário e, em seguida, vamos executar o aplicativo.

Adicionar um botão no formulário

  1. Selecione Caixa de ferramentas para abrir a janela de submenu Caixa de Ferramentas.

    Screenshot to select the Toolbox to open the Toolbox window.

    (Se você não enxergar a opção de submenu Caixa de Ferramentas, poderá abri-la na barra de menus. Para fazer isso, Exibir>Caixa de Ferramentas. Ou pressione Ctrl+Alt+X.)

  2. Expanda Controles Comuns e selecione o ícone Fixar para encaixar a janela Caixa de Ferramentas.

    Screenshot to select the Pin icon to pin the Toolbox window to the IDE.

  3. Selecione o controle Botão e, em seguida, arraste-o para o formulário.

    Screenshot to add a button to the form.

  4. Na janela Propriedades, localize Texto, altere o nome de button1 para Click this e, em seguida, pressione Enter.

    Screenshot to add text to the button on the form by using the Properties window.

    (Se você não enxergar a janela Propriedades, poderá abri-la na barra de menus. Para fazer isso, selecione Exibir>Janela Propriedades. Ou pressione F4.)

  5. Na seção Design da janela Propriedades, altere o nome de button1 para btnClickThis e, em seguida, pressione Enter.

    Screenshot to add a function to the button on the form by using the Properties window.

    Observação

    Se a lista estiver em ordem alfabética na janela Propriedades, como alternativa, o button1 aparecerá na seção (DataBindings).

Adicionar um rótulo ao formulário

Agora que adicionamos um controle de botão para criar uma ação, vamos adicionar um controle de rótulo para enviar o texto.

  1. Selecione o controle Rótulo da janela Caixa de Ferramentas e, então, arraste-a para o formulário e solte-a abaixo do botão Clique aqui.

  2. Na seção Design ou na seção (DataBindings) da janela Propriedades, altere o nome de label1 para lblHelloWorld e, em seguida, pressione Enter.

Adicionar código ao formulário

  1. Na janela Form1.cs [Design], clique duas vezes no botão Clique aqui para abrir a janela Form1.cs.

    (Como alternativa, você pode expandir Form1.cs no Gerenciador de Soluções e, em seguida, escolher Form1.)

  2. Na janela Form1.cs, após a linha private void, digite ou insira lblHelloWorld.Text = "Hello World!"; conforme mostrado na captura de tela a seguir:

    Screenshot to add code to the form

Executar o aplicativo

  1. Selecione o botão Iniciar para executar o aplicativo.

    Screenshot to select Start to debug and run the app.

    Várias coisas acontecerão. No IDE do Visual Studio, a janela Ferramentas de Diagnóstico será aberta, e uma janela de saída também. Porém, fora do IDE, uma caixa de diálogo Form1 será exibida. Ele incluirá seu botão Clique aqui e o texto label1.

  2. Selecione o botão Clique aqui na caixa de diálogo Form1. Observe que o texto label1 é alterado para Olá, Mundo!.

    Screenshot to show a Form1 dialog box that includes label1 text.

  3. Feche a caixa de diálogo Form1 para parar de executar o aplicativo.

Criar o aplicativo

Depois de selecionar o seu modelo de projeto do C# e nomear seu arquivo, o Visual Studio abrirá um formulário para você. Um formulário é uma interface do usuário do Windows. Vamos criar um aplicativo "Olá, Mundo" ao adicionar controles ao formulário e, em seguida, vamos executar o aplicativo.

Adicionar um botão no formulário

  1. Escolha Caixa de ferramentas para abrir a janela de submenu Caixa de Ferramentas.

    Choose the Toolbox to open the Toolbox window

    (Se você não enxergar a opção de submenu Caixa de Ferramentas, poderá abri-la na barra de menus. Para fazer isso, Exibir>Caixa de Ferramentas. Ou pressione Ctrl+Alt+X.)

  2. Escolha o ícone Fixar para encaixar a janela Caixa de Ferramentas.

    Choose the Pin icon to pin the Toolbox window to the IDE

  3. Escolha o controle Botão e, em seguida, arraste-o para o formulário.

    Add a button to the form

  4. Na janela Propriedades, localize Texto, altere o nome de Button1 para Click this e, em seguida, pressione Enter.

    Add text to the button on the form

    (Se você não enxergar a janela Propriedades, poderá abri-la na barra de menus. Para fazer isso, escolha Exibir>Janela Propriedades. Ou pressione F4.)

  5. Na seção Design da janela Propriedades, altere o nome de Button1 para btnClickThis e, em seguida, pressione Enter.

    Add a function to the button on the form

    Observação

    Se a lista estiver em ordem alfabética na janela Propriedades, como alternativa, o Button1 aparecerá na seção (DataBindings).

Adicionar um rótulo ao formulário

Agora que adicionamos um controle de botão para criar uma ação, vamos adicionar um controle de rótulo para enviar o texto.

  1. Selecione o controle Rótulo da janela Caixa de Ferramentas e, então, arraste-a para o formulário e solte-a abaixo do botão Clique aqui.

  2. Na seção Design ou na seção (DataBindings) da janela Propriedades, altere o nome de Label1 para lblHelloWorld e, em seguida, pressione Enter.

Adicionar código ao formulário

  1. Na janela Form1.cs [Design], clique duas vezes no botão Clique aqui para abrir a janela Form1.cs.

    (Como alternativa, você pode expandir Form1.cs em Gerenciador de Soluções e, em seguida, escolher Exibir Código(ou pressionar F7) no menu exibido com o clique do botão direito do mouse em Form1.cs.)

  2. Na janela Form1.cs, após a linha private void, digite ou insira lblHelloWorld.Text = "Hello World!"; conforme mostrado na captura de tela a seguir:

    Add code to the form

Executar o aplicativo

  1. Escolha o botão Iniciar para executar o aplicativo.

    Choose Start to debug and run the app

    Várias coisas acontecerão. No IDE do Visual Studio, a janela Ferramentas de Diagnóstico será aberta, e uma janela de saída também. Porém, fora do IDE, uma caixa de diálogo Form1 será exibida. Ela incluirá o botão Clique aqui e o texto Label1.

  2. Escolha o botão Clique aqui na caixa de diálogo Form1. Observe que o texto Label1 é alterado para Olá, Mundo!.

    A Form1 dialog box that includes Label1 text

  3. Feche a caixa de diálogo Form1 para parar de executar o aplicativo.

Próximas etapas

Parabéns por concluir este tutorial. Para saber mais, continue com o tutorial a seguir:

Tutorial: Criar um visualizador de imagens

Confira também