Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Nesta introdução ao ambiente integrado de desenvolvimento (IDE) do Visual Studio, cria uma aplicação "Hello World" que corre em qualquer dispositivo com Windows 10 ou posterior. Para isso, utiliza-se um modelo de projeto do Windows App SDK (WinUI 3), a Extensible Application Markup Language (XAML) e a linguagem de programação C#.
Observação
O WinUI 3 é o componente nativo da plataforma de interface que vem com o Windows App SDK. Está completamente desacoplado dos SDKs do Windows. Para obter mais informações, consulte WinUI 3.
Pré-requisitos
- Precisa do Visual Studio 2026 ou da versão mais recente do Visual Studio 2022 para completar este tutorial. Para uma versão gratuita, consulte downloads do Visual Studio.
- Cargas de trabalho e componentes necessários para o desenvolvimento com WinUI e o SDK de Aplicativo Windows. Para verificar ou instalar uma carga de trabalho no Visual Studio, selecione Ferramentas >Obter Ferramentas e Recursos. Para obter mais informações, consulte Alterar Cargas de Trabalho ou Componentes Individuais.
Na guia Cargas de trabalho do instalador do Visual Studio, selecione o seguinte:
Para desenvolvimento de aplicativos em C# usando o SDK de aplicativos do Windows, selecione Desenvolvimento de aplicativos WinUI.
Para desenvolvimento de aplicativos em C# usando o SDK de aplicativos do Windows, selecione Desenvolvimento de aplicativos WinUI.
Observação
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 de aplicativos Windows.
Criar um projeto
Primeiro, crie um projeto WinUI 3. O tipo de projeto vem com todos os arquivos de modelo que você precisa, antes mesmo de adicionar qualquer coisa!
Abra o Visual Studio e, na janela Iniciar, escolha Criar um novo projeto.
No ecrã Criar um novo projeto , introduza WinUI na caixa de pesquisa, escolha o modelo C# para WinUI Blank App (Packaged) e depois escolha Próximo.
Dê um nome ao projeto, HelloWorlde escolha Criar.
Abra o Visual Studio e, na janela Iniciar, escolha Criar um novo projeto.
Na janela de Criar um novo projeto, introduza winui na caixa de pesquisa, escolha o modelo C# para Aplicação em Branco, Empacotada (WinUI 3 no Ambiente de Trabalho) e depois escolha Seguinte.
Dê um nome ao projeto, HelloWorlde escolha Criar.
Observação
Se este artigo for a primeira vez que usa o Visual Studio para criar uma aplicação SDK de aplicações Windows, pode aparecer um diálogo de Definições . Escolha modo de desenvolvedore, em seguida, escolha Sim.
O Visual Studio instala outro pacote do Modo Desenvolvedor para si. Quando a instalação do pacote estiver concluída, feche o diálogo de Definições .
Criar o aplicativo
É hora de começar a desenvolver. Aqui adicionas um controlo de botão, adicionas uma ação ao botão e depois executas a aplicação Hello World para ver como fica.
Adicionar um botão à área de design
No Gerenciador de Soluções, clique duas vezes MainWindow.xaml para abrir o editor de marcação XAML.
O do Editor XAML é onde você pode adicionar ou alterar marcações. Ao contrário dos projetos UWP, o WinUI 3 não tem um Design view.
Dentro do
<Grid>item, comece a escrever<Button. O Intellisense oferece-te uma opção de botões. Prima Tab para aceitar.
No Gerenciador de Soluções, clique duas vezes MainWindow.xaml para abrir o editor de marcação XAML.
O do Editor XAML é onde você pode adicionar ou alterar marcações. Ao contrário dos projetos UWP, o WinUI 3 não tem um Design view.
Revise o controlo Botão aninhado no do StackPanel na raiz da Window.
Alterar o rótulo no botão
No Editor XAML, altere o valor do Conteúdo dos Botões do seu valor atual para "Hello World!".
Coloca o cursor na
<Button>tag inicial do elemento (depois dos atributos existentes, comoContent) e começa a escrever Click. A Intellisense oferece um novo gestor de eventos chamado Button_Click. Trabalhas com esse código na secção seguinte.
No Editor XAML, altere o valor do Conteúdo dos Botões do seu valor atual para "Hello World!".
Observe que o botão também tem um manipulador de eventos Click chamado myButton_Click especificado. Trabalhe com isso no próximo passo.
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. Neste caso, adiciona uma ação desencadeada pelo Hello World! botão.
No Explorador de Soluções, clique duas vezes em MainWindow.xaml.cs, a página da camada de código.
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 mudá-lo, para que fique assim:
Aqui está 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 Explorador de Soluções, clique duas vezes em MainWindow.xaml.cs, a página da camada de código.
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 mudá-lo, para que fique assim:
Aqui está 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 de ContentDialog para exibir uma mensagem de boas-vindas em um controle pop-up modal dentro da janela atual. Para mais informações sobre a utilização de Microsoft.UI.Xaml.Controls.ContentDialog, veja Classe ContentDialog.
Execute o aplicativo
Está na altura de construir, implementar e lançar a aplicação Hello World utilizando o SDK da Aplicação Windows para ver como fica. Veja como.
Usa o botão Play para iniciar a aplicação na máquina local. Tem o texto HelloWorld (Pacote).
Como alternativa, você pode escolher Depurar>Iniciar a Depuração na barra de menus ou pressionar F5 para iniciar seu aplicativo.
Veja seu aplicativo, que aparece logo depois que uma tela inicial desaparece. O aplicativo deve ser semelhante a esta imagem:
Selecione o botão Hello World.
O seu dispositivo com Windows 10 ou mais recente mostra uma mensagem que diz "Bem-vindo à sua primeira aplicação do Windows App SDK" com o título "Hello from HelloWorld." Selecione Ok para descartar a mensagem.
Para fechar o aplicativo, selecione o botão Parar Depuração na barra de ferramentas. Alternativamente, escolha Debug>Stop Debugging na barra de menu, 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 Windows App SDK, WinUI 3 e o IDE do Visual Studio. Para saber mais, continue com o seguinte tutorial:
Estes recursos também podem ser úteis: