本教程系列演示如何使用 XAML 和 C# 创建 WinUI 3 应用。 你将创建的应用是一个便笺应用,用户可以在其中创建、保存和加载多个笔记。 可以从 GitHub 存储库下载或查看本教程的代码。
本教程中,您将学习如何:
- 使用 XAML 标记定义应用的用户界面。
- 通过 C# 代码与 XAML 元素交互。
- 保存并加载本地文件系统中的文件。
- 创建视图并将其绑定到数据。
- 使用导航在应用中的页面中移动和移出页面。
- 使用文档和示例应用等资源创建自己的应用。
你将使用 Visual Studio 2022 创建一个应用,该应用可用于输入笔记并将其保存到本地应用存储。 可在此处找到此应用的源代码。 该应用将有两个页面:
-
NotePage- 用于编辑单个笔记的页面。 -
AllNotesPage- 显示所有已保存笔记的页面。
最终的应用程序如下所示:
AllNotesPage
NotePage
创建 Visual Studio 项目
若要开始本教程,必须使用 C# 项目模板在 Visual Studio Blank App, Packaged (WinUI 3 in Desktop) 中创建 WinUI 3 应用项目。 创建项目时,请使用以下设置:
项目名称
此属性必须设置为
WinUINotes。 如果项目的名称不同,则从本教程复制和粘贴的代码可能会导致生成错误。 这是因为 Visual Studio 使用项目名称作为应用代码的默认 命名空间 。Windows 应用 SDK
本教程使用 Windows 应用 SDK 1.7 中的新增功能。 必须确保 Windows 应用 SDK NuGet 包已更新到版本 1.7 或更高版本。
重要
如果以前尚未创建 WinUI 3 项目,请按照 “开始开发 Windows 应用 ”中的步骤,确保开发环境和 Visual Studio 项目设置正确。
运行空白应用项目(如 “开始开发 Windows 应用”中所述)时,应会看到如下所示的空窗口:
小窍门
生成 Windows 应用时,经常引用 API 参考文档和概念文档。 在本教程中,你将在文本中看到内联链接,并在标记为“在 docs:中了解详细信息”的组中。 这些链接是可选的;无需遵循它们即可完成本教程。 如果要记下开始创建自己的应用时所需的信息的位置,则会提供它们。