Document .NET 11 file-based apps: DLL includes, dotnet reference, and Native AOT reuse

[Copilot]

The file-based apps article was missing coverage of several new .NET 11 capabilities: splitting apps into multiple files, reusing Native AOT build outputs, dotnet reference support, and including compiled DLL references.

#:include enhancements

• Added *.dll → Reference item-type mapping so file-based apps can reference prebuilt libraries directly:

  #:include ./libs/MyLibrary.dll

• Documented that #:sdk, #:property, and #:package can now appear as duplicates across included files as long as their values match, enabling self-contained library files with their own dependencies.

dotnet reference support

• Added guidance on managing #:project references via the CLI instead of editing directives by hand:

  dotnet reference add --file app.cs ../SharedLibrary/SharedLibrary.csproj
  dotnet reference list --file app.cs
  dotnet reference remove --file app.cs ../SharedLibrary/SharedLibrary.csproj
  

Native AOT build output reuse

• Added a new "Reuse Native AOT build outputs" subsection describing cached launches (dotnet run --file app.cs, dotnet run app.cs, dotnet app.cs), fallback behavior when cached output doesn't match current arguments, dotnet format support for file-based apps, and how the SDK artifacts layout affects output location.

Each new capability is called out with a version note indicating .NET 11+ availability.

• Fixes Add detail for new features in file-based apps #55890

---

Internal previews

File	Preview link
docs/core/sdk/file-based-apps.md	Learn preview

Build report

[Copilot]

Copilot wasn't able to review any files in this pull request.

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.