csharp-scripts

Use file-based apps in .NET 10 or later by running `dotnet hello.cs` directly on a .cs file with top-level statements. The CLI builds and runs the file automatically, caching the build so subsequent runs are fast.

Add a `#:package` directive at the top of the file, before any using directives, with a version such as `#:package Humanizer@2.14.1`. Use `@*` for the latest version or `@*-*` to include pre-release versions.

No, file-based apps require .NET SDK 10 or later, and multi-file directives like `#:include` require SDK 10.0.300 or later. On older SDKs, create a temporary console project with `dotnet new console` and run it with `dotnet run` instead.

Helper .cs files are not compiled automatically; the entry-point file must reference them with `#:include Helpers.cs` or a glob pattern. Check that your SDK is 10.0.300 or later, since earlier 10.0.x builds do not support include directives.

File-based apps enable native AOT by default, so reflection-based `JsonSerializer.Serialize<T>` calls fail at runtime. Use source-generated serialization with a `JsonSerializerContext` partial class annotated with `JsonSerializable` attributes.

Convert when the app needs build customization, tests, publish configuration, or integration into an existing solution. Run `dotnet project convert hello.cs` to generate a standard project from the file-based app.