Constrói uma aplicação de notas para o WinUI 3

Esta série de tutoriais demonstra como criar uma aplicação WinUI usando XAML e C#. O aplicativo que você criará é um aplicativo de notas, onde o usuário pode criar, salvar e carregar várias notas. Pode descarregar ou ver o código deste tutorial no repositório GitHub.

Comece aqui depois de conseguir compilar e executar um projeto vazio. Esta é uma introdução passo a passo aos fundamentos do WinUI 3 usando o Visual Studio; não é necessário assistente de programação com IA nem o MVVM Toolkit.

Neste tutorial, aprenderás como:

  • Use a marcação XAML para definir a interface do usuário do aplicativo.
  • Interaja com elementos XAML por meio de código C#.
  • Salve e carregue arquivos do sistema de arquivos local.
  • Crie vistas e associe-as aos dados.
  • Use a navegação para mover de e para páginas no aplicativo.
  • Use recursos como documentação e aplicativos de exemplo para criar seu próprio aplicativo.

Vais criar uma aplicação que podes usar para inserir uma nota e guardá-la no armazenamento local da app. O aplicativo terá duas páginas:

  • NotePage - uma página para editar uma única nota.
  • AllNotesPage - uma página para mostrar todas as notas salvas.

A candidatura final é apresentada abaixo:

AllNotesPage

Captura de ecrã final da aplicação de notas, mostrando três notas guardadas.

Página de Observação

Captura de ecrã final da aplicação Notas, mostrando uma nova nota em branco.

Crie o projeto do Visual Studio

Siga o caminho do Visual Studio no Quickstart: Crie e execute um projeto WinUI 3 para instalação de ferramentas e criação de projetos. Use um projeto C# embalado com estas definições específicas do tutorial:

  • Project Nome

    Isso deve ser definido como WinUINotes. Se o project tiver um nome diferente, o código que copiar e colar deste tutorial pode resultar em erros de compilação. Isto deve-se ao facto de o Visual Studio usar o nome do projeto como o namespace predefinido para o código da sua aplicação.

  • SDK de aplicativos do Windows

    Este tutorial utiliza funcionalidades disponíveis no SDK de Aplicações Windows 1.7 e posteriores. Certifique-se de que o pacote NuGet do SDK de Aplicações Windows está atualizado para a versão 1.7 ou posterior.

Compile e execute o projeto WinUINotes em branco antes de continuar. Deverias ver uma janela vazia que se parece com esta:

A janela da aplicação de notas com uma barra de título e uma área de conteúdo vazia.

Sugestão

Você frequentemente consultará documentos de referência de API e documentos conceituais ao criar aplicativos do Windows. Neste tutorial, você verá links embutidos no texto e em grupos rotulados como "Saiba mais nos documentos:". Estes links são opcionais; Você não precisa segui-los para concluir o tutorial. Eles são fornecidos caso você queira anotar onde encontrar as informações necessárias quando começar a criar seus próprios aplicativos.