Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Nesta introdução ao IDE (ambiente de desenvolvimento integrado) do Visual Studio, você cria um aplicativo "Olá, Mundo" que é executado em qualquer dispositivo Windows 10 ou posterior. Para fazer isso, use um modelo de projeto do SDK de Aplicativo do Windows (WinUI 3), XAML (Extensible Application Markup Language) e a linguagem de programação C#.
Nota
O WinUI 3 é o componente nativo da plataforma de interface do usuário que é fornecido com o SDK do Aplicativo do Windows. Ele é completamente dissociado dos SDKs do Windows. Para obter mais informações, consulte WinUI 3.
Pré-requisitos
- Você precisa do Visual Studio 2026 ou da versão mais recente do Visual Studio 2022 para concluir este tutorial. Para obter uma versão gratuita, consulte os downloads do Visual Studio.
- Cargas de trabalho e componentes necessários para o desenvolvimento com o WinUI e o SDK do Aplicativo do Windows. Para verificar ou instalar uma carga de trabalho no Visual Studio, selecione Ferramentas>Obter Ferramentas e Recursos. Para obter mais informações, consulte Modificar cargas de trabalho ou componentes individuais.
Na guia Cargas de Trabalho do Instalador do Visual Studio, selecione o seguinte:
Para o desenvolvimento de aplicativos em C# usando o SDK do Aplicativo do Windows, selecione o desenvolvimento de aplicativos WinUI.
Para o desenvolvimento de aplicativos em C# usando o SDK do Aplicativo do Windows, selecione o desenvolvimento de aplicativos WinUI.
Nota
No Visual Studio 17.10 – 17.12, essa carga de trabalho é chamada de desenvolvimento de aplicativos do Windows.
Para obter detalhes, consulte Instalar ferramentas para o SDK do Aplicativo do Windows.
Criar um projeto
Primeiro, crie um projeto WinUI 3. O tipo de projeto vem com todos os arquivos de modelo necessários, antes mesmo de adicionar qualquer coisa!
Abra o Visual Studio e, na janela inicial, escolha Criar um novo projeto.
Na tela Criar um novo projeto , insira WinUI na caixa de pesquisa, escolha o modelo C# para o Aplicativo WinUI em Branco (Empacotado) e escolha Avançar.
Dê um nome ao projeto, HelloWorld, e escolha Criar.
Abra o Visual Studio e, na janela inicial, escolha Criar um novo projeto.
Na tela Criar um novo projeto , insira winui na caixa de pesquisa, escolha o modelo C# para modelo C# para Aplicativo em Branco, Empacotado (WinUI 3 na Área de Trabalho) e escolha Avançar.
Dê um nome ao projeto, HelloWorld, e escolha Criar.
Nota
Se este artigo for a primeira vez que você usa o Visual Studio para criar um aplicativo SDK de Aplicativo do Windows, uma caixa de diálogo Configurações poderá aparecer. Escolha Modo Desenvolvedore então escolha Sim.
O Visual Studio instala outro pacote do Modo de Desenvolvedor para você. Quando a instalação do pacote for concluída, feche a caixa de diálogo Configurações .
Criar o aplicativo
É hora de começar a desenvolver. Aqui você adiciona um controle de botão, adiciona uma ação ao botão e, em seguida, executa o aplicativo Hello World para ver a aparência dele.
Adicionar um botão à tela de Design
No Gerenciador de Soluções, clique duas vezes em MainWindow.xaml para abrir o editor de marcação XAML.
O Editor de XAML é onde você pode adicionar ou alterar a marcação. Ao contrário dos projetos UWP, o WinUI 3 não tem uma exibição Design.
Dentro do
<Grid>item, comece a digitar<Button. O Intellisense oferece uma opção de botão. Pressione Tab para aceitar.
No Gerenciador de Soluções, clique duas vezes em MainWindow.xaml para abrir o editor de marcação XAML.
O Editor de XAML é onde você pode adicionar ou alterar a marcação. Ao contrário dos projetos UWP, o WinUI 3 não tem uma exibição Design.
Examine o controle de Botão aninhado no StackPanel na raiz da Janela.
Alterar o rótulo no botão
No Editor XAML, altere o valor do Conteúdo do Botão de seu valor atual para "Olá, Mundo!".
Coloque o
<Button>cursor na marca inicial do elemento (após os atributos existentes, comoContent) e comece a digitar Clique. O Intellisense oferece um novo manipulador de eventos chamado Button_Click. Você trabalha com esse código na próxima seção.
No Editor XAML, altere o valor do Conteúdo do Botão de seu valor atual para "Olá, Mundo!".
Observe que o botão também tem um manipulador de eventos de Clique chamado myButton_Click especificado. Você irá trabalhar com isso na próxima etapa.
Modificar o manipulador de eventos
Um manipulador de eventos parece complicado, mas é apenas outro nome para o código que é chamado quando um evento acontece. Nesse caso, ele adiciona uma ação disparada pelo Hello World! botão.
No Gerenciador de Soluções, clique duas vezes em MainWindow.xaml.cs, na página code-behind.
Edite o código do manipulador de eventos na janela do editor C# que é aberta.
Aqui é onde as coisas ficam interessantes. O manipulador de eventos padrão tem esta aparência:
Vamos alterá-lo, para que fique assim:
Este é o código para copiar e colar:
private async void Button_Click(object sender, RoutedEventArgs e) { var welcomeDialog = new ContentDialog() { Title = "Hello from HelloWorld", Content = "Welcome to your first Windows App SDK app.", CloseButtonText = "Ok", XamlRoot = ((FrameworkElement)sender).XamlRoot }; await welcomeDialog.ShowAsync(); }
No Gerenciador de Soluções, clique duas vezes em MainWindow.xaml.cs, na página code-behind.
Edite o código do manipulador de eventos na janela do editor C# que é aberta.
Aqui é onde as coisas ficam interessantes. O manipulador de eventos padrão tem esta aparência:
Vamos alterá-lo, para que fique assim:
Este é o código para copiar e colar:
private async void myButton_Click(object sender, RoutedEventArgs e) { var welcomeDialog = new ContentDialog() { Title = "Hello from HelloWorld", Content = "Welcome to your first Windows App SDK app.", CloseButtonText = "Ok", XamlRoot = myButton.XamlRoot }; await welcomeDialog.ShowAsync(); }
O que acabamos de fazer?
O código usa o controle ContentDialog para exibir uma mensagem de boas-vindas em um controle pop-up modal dentro da janela atual. Para obter mais informações sobre como usar Microsoft.UI.Xaml.Controls.ContentDialog, consulte a Classe ContentDialog.
Executar o aplicativo
É hora de criar, implantar e iniciar o aplicativo Hello World Windows App SDK para ver a aparência dele. Veja como.
Use o botão Reproduzir para iniciar o aplicativo no computador local. Ele tem o texto HelloWorld (Pacote).
Como alternativa, você pode escolher Depurar>Iniciar Depuração na barra de menus ou pressionar F5 para iniciar seu aplicativo.
Veja o aplicativo, que aparece logo depois que uma tela inicial desaparece. O aplicativo deve ser semelhante a esta imagem:
Selecione o botão Hello World.
Seu dispositivo Windows 10 ou posterior exibe uma mensagem que diz "Bem-vindo ao seu primeiro aplicativo SDK de Aplicativo do Windows" com o título "Olá do HelloWorld". Selecione Ok para ignorar a mensagem.
Para fechar o aplicativo, selecione o botão Parar Depuração na barra de ferramentas. Como alternativa, escolha Depurar>Parar depuração na barra de menus ou pressione Shift+F5.
Conteúdo relacionado
Parabéns por concluir este tutorial! Esperamos que você tenha aprendido algumas noções básicas sobre o SDK do Aplicativo do Windows, o WinUI 3 e o IDE do Visual Studio. Para saber mais, continue com o seguinte tutorial:
Esses recursos também podem ser úteis: