Document `#:include` support in file-based apps by Copilot · Pull Request #53350 · dotnet/docs

Copilot · 2026-04-22T21:11:14Z

The file-based apps article was missing the new #:include directive introduced with .NET 11 Preview 3 and backported to .NET SDK 10.0.3xx. This update adds directive coverage and clarifies how included source files participate in compilation.

Supported directives
- Added #:include to the top-level list of supported file-based app directives.
New #:include directive section
- Added dedicated documentation for #:include.
- Included syntax examples for including files from the app root and subfolders.
- Added version availability note: .NET 11 Preview 3 and .NET SDK 10.0.3xx+.
Default included items clarification
- Documented that files referenced by #:include are included in compilation.

#:include helpers.cs
#:include models/customer.cs

Console.WriteLine("Hello!");

Internal previews

📄 File	🔗 Preview link
docs/core/sdk/file-based-apps.md	docs/core/sdk/file-based-apps

Agent-Logs-Url: https://github.com/dotnet/docs/sessions/27329bc4-87c0-469b-b146-55d906707455 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

gewarren · 2026-04-22T21:57:14Z

@copilot Please respond to feedback.

Reordered the list of supported directives for clarity and moved the `#:project` section to a new position.

Removed duplicate section for the `#:include` directive in the documentation.

Copilot

Pull request overview

Updates the file-based apps documentation to cover the newly supported #:include directive so developers can split a file-based app across multiple source files.

Changes:

Adds #:include to the supported directives list.
Adds a new #:include subsection with examples and an availability note.

Agent-Logs-Url: https://github.com/dotnet/docs/sessions/a2dfc33b-80ca-4bce-a649-cb0f6ef97058 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Copilot · 2026-04-22T22:09:33Z

@copilot Please respond to feedback.

Done—feedback has been applied in 95713a7.

adegeo · 2026-04-29T17:30:49Z

+#:include models/customer.cs
+```
+
+The `#:include` directive is available in .NET 11 Preview 3 and .NET SDK 10.0.3xx and later.


We should wait for this to actually land in 3xx. It might not, you never know.

Do you think it's a good idea to put this up front? Someone may get here, try it, find it not working, never see that paragraph and complain it doesn't work.

I think we should put this up front, yeah, immediately under the heading.

gewarren · 2026-05-14T17:46:40Z

Feature PR is closed, so abandoning this PR.

DamianEdwards · 2026-05-17T16:49:13Z

This feature landed in 10.0.300 last week so reopening.

DamianEdwards · 2026-05-17T16:50:06Z

+
+Includes another C# source file in the file-based app.
+
+Included files compile as part of the same app. They can add types, top-level statements, and other declarations.


included files can't add top-level statements, only the entry-point file can have top-level statements

DamianEdwards · 2026-05-17T16:52:29Z

+
+### `#:include`
+
+Includes another C# source file in the file-based app.


#:include supports other file types, not just .cs. In .NET 10.0.300 it supports .cs, .resx, .json, and .razor, with each being mapped to the appropriate item type:

.cs -> Compile

.resx -> EmbeddedResource

.json -> None

.razor -> Content

DamianEdwards · 2026-05-17T16:54:50Z

+
+```csharp
+#:include helpers.cs
+#:include models/customer.cs


The path also supports globs, e.g. #:include shared/**/*.cs, but it's worth noting that globs will disable the build caching currently. Also you can use MSBuild properties too, e.g. #:include $(MSBuildProjectName).*.cs in an app.cs file will result in app.helpers.cs, etc. being included (maybe worth a link to https://learn.microsoft.com/visualstudio/msbuild/msbuild-reserved-and-well-known-properties).

Initial plan

d8ea0eb

Copilot AI assigned Copilot and gewarren Apr 22, 2026

Copilot AI linked an issue Apr 22, 2026 that may be closed by this pull request

File-based apps can include other code files #53204

Open

Copilot started work on behalf of gewarren April 22, 2026 21:11 View session

Document #:include support for file-based apps

da16212

Agent-Logs-Url: https://github.com/dotnet/docs/sessions/27329bc4-87c0-469b-b146-55d906707455 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

dotnet-policy-service Bot added the dotnet-fundamentals/svc label Apr 22, 2026

Copilot AI changed the title ~~[WIP] Update article on file-based apps with include syntax~~ Document #:include support in file-based apps Apr 22, 2026

Copilot finished work on behalf of gewarren April 22, 2026 21:14

Copilot AI requested a review from gewarren April 22, 2026 21:14

gewarren reviewed Apr 22, 2026

View reviewed changes

Comment thread docs/core/sdk/file-based-apps.md Outdated

Comment thread docs/core/sdk/file-based-apps.md Outdated

Comment thread docs/core/sdk/file-based-apps.md Outdated

gewarren added 2 commits April 22, 2026 14:59

Reorganize supported directives in file-based apps docs

dce1256

Reordered the list of supported directives for clarity and moved the `#:project` section to a new position.

Remove duplicate #:include directive section

c26788a

Removed duplicate section for the `#:include` directive in the documentation.

gewarren reviewed Apr 22, 2026

View reviewed changes

Comment thread docs/core/sdk/file-based-apps.md Outdated

Update docs/core/sdk/file-based-apps.md

45e2f60

gewarren approved these changes Apr 22, 2026

View reviewed changes

gewarren marked this pull request as ready for review April 22, 2026 22:03

gewarren requested a review from a team as a code owner April 22, 2026 22:03

Copilot AI review requested due to automatic review settings April 22, 2026 22:03

Copilot started reviewing on behalf of gewarren April 22, 2026 22:03 View session

Copilot AI reviewed Apr 22, 2026

View reviewed changes

Comment thread docs/core/sdk/file-based-apps.md

Copilot started work on behalf of gewarren April 22, 2026 22:06 View session

Copilot AI and others added 4 commits April 22, 2026 22:07

Clarify #:include compilation behavior in file-based apps docs

94d3ead

Agent-Logs-Url: https://github.com/dotnet/docs/sessions/a2dfc33b-80ca-4bce-a649-cb0f6ef97058 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Refine #:include clarification wording for list clarity

b5f492a

Agent-Logs-Url: https://github.com/dotnet/docs/sessions/a2dfc33b-80ca-4bce-a649-cb0f6ef97058 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Adjust include clarification phrasing

70062cf

Agent-Logs-Url: https://github.com/dotnet/docs/sessions/a2dfc33b-80ca-4bce-a649-cb0f6ef97058 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Split include clarification into two sentences

95713a7

Agent-Logs-Url: https://github.com/dotnet/docs/sessions/a2dfc33b-80ca-4bce-a649-cb0f6ef97058 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Copilot finished work on behalf of gewarren April 22, 2026 22:10

Copilot AI requested a review from gewarren April 22, 2026 22:10

gewarren requested a review from adegeo April 28, 2026 17:57

adegeo added the DO NOT MERGE label Apr 29, 2026

adegeo reviewed Apr 29, 2026

View reviewed changes

gewarren closed this May 14, 2026

DamianEdwards reopened this May 17, 2026

DamianEdwards reviewed May 17, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Document `#:include` support in file-based apps#53350

Document `#:include` support in file-based apps#53350
Copilot wants to merge 9 commits into
mainfrom
copilot/update-file-based-apps-article

Copilot AI commented Apr 22, 2026 •

edited by github-actions Bot

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gewarren commented Apr 22, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI commented Apr 22, 2026

Uh oh!

adegeo Apr 29, 2026

Uh oh!

DamianEdwards May 17, 2026

Uh oh!

gewarren commented May 14, 2026

Uh oh!

DamianEdwards commented May 17, 2026

Uh oh!

DamianEdwards May 17, 2026

Uh oh!

DamianEdwards May 17, 2026 •

edited

Loading

Uh oh!

DamianEdwards May 17, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants


		Includes another C# source file in the file-based app.

		Included files compile as part of the same app. They can add types, top-level statements, and other declarations.


		### `#:include`

		Includes another C# source file in the file-based app.

Conversation

Copilot AI commented Apr 22, 2026 • edited by github-actions Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Internal previews

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gewarren commented Apr 22, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI commented Apr 22, 2026

Uh oh!

adegeo Apr 29, 2026

Choose a reason for hiding this comment

Uh oh!

DamianEdwards May 17, 2026

Choose a reason for hiding this comment

Uh oh!

gewarren commented May 14, 2026

Uh oh!

DamianEdwards commented May 17, 2026

Uh oh!

DamianEdwards May 17, 2026

Choose a reason for hiding this comment

Uh oh!

DamianEdwards May 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DamianEdwards May 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Copilot AI commented Apr 22, 2026 •

edited by github-actions Bot

Loading

DamianEdwards May 17, 2026 •

edited

Loading

DamianEdwards May 17, 2026 •

edited

Loading