.NET file-based app 多文件支持
内容提要
.NET 11 Preview 3 引入了多文件支持，允许将公共逻辑写入单独的帮助类文件以实现复用。用户需在项目属性中声明实验性支持。示例代码展示了如何通过 `#:include` 引入帮助类，并在主文件中调用其方法。此功能在后续版本中将不再需要显式声明。
关键要点
-
.NET 11 Preview 3 引入了多文件支持，允许将公共逻辑写入单独的帮助类文件以实现复用。
-
用户需在项目属性中声明实验性支持，使用 <ExperimentalFileBasedProgramEnableIncludeDirective>true</ExperimentalFileBasedProgramEnableIncludeDirective>。
-
示例代码展示了如何通过 #:include 引入帮助类，并在主文件中调用其方法。
-
后续版本将不再需要显式声明实验性支持属性。
-
除了基本的包含文件，还可以在被包含文件中添加引用，需设置 <ExperimentalFileBasedProgramEnableTransitiveDirectives>true</ExperimentalFileBasedProgramEnableTransitiveDirectives>。
-
支持的功能包括 include 和 exclude，后者相当于 <Compile Remove/>。
-
dotnet-exec 也支持多文件功能，相关更新将在后续的 .NET 10 SDK 中可用。
延伸解读
实验性功能的注意事项
在使用 .NET 11 Preview 3 的多文件支持时，用户需注意该功能仍处于实验阶段。必须在项目属性中显式声明相关属性，否则将无法正常使用。建议将属性声明放在 Directory.Build.props 文件中，以便于管理和复用。
未来版本的变化
随着后续版本的发布，.NET 将不再需要显式声明实验性支持属性。这意味着开发者在使用多文件支持时将获得更简化的体验，减少了配置的复杂性，提升了开发效率。
多文件支持的实际应用
多文件支持允许开发者将公共逻辑分离到独立的帮助类文件中，这不仅提高了代码的复用性，还使得项目结构更加清晰。开发者可以通过简单的 `#:include` 指令来引入这些帮助类，方便调用其方法。
延伸问答
.NET 11 Preview 3 的多文件支持有什么新功能？
.NET 11 Preview 3 引入了多文件支持，允许将公共逻辑写入单独的帮助类文件以实现复用。
如何在项目中启用多文件支持？
用户需在项目属性中声明实验性支持，使用 <ExperimentalFileBasedProgramEnableIncludeDirective>true</ExperimentalFileBasedProgramEnableIncludeDirective>。
如何在主文件中调用帮助类的方法？
可以通过 #:include 引入帮助类，并在主文件中调用其方法，例如 Helper.WriteToConsole("Hello, World!");
后续版本中多文件支持的声明要求会有什么变化？
后续版本将不再需要显式声明实验性支持属性。
除了 include，还有哪些其他指令支持？
除了基本的 include，还支持 exclude，后者相当于 <Compile Remove/>。
dotnet-exec 如何支持多文件功能？
dotnet-exec 从 0.36.0 版本开始支持多文件功能，相关更新将在后续的 .NET 10 SDK 中可用。
