Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add migration guidance for existing F# MVC applications upgrading from .NET 10 to .NET 11.

Chiusa
  • Qualcosa non va?
#37,686 1 commento 1 reazione 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@SkyDevLab ci sta già lavorando.

Dal 13/10/2026.

  • #37851 di @SkyDevLab — aperta

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

11.0 aspnet-core/svc migration/subsvc Pri1 Source - Docs.ms
Description

F# MVC projects generated by earlier templates use the Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation package and call .AddRazorRuntimeCompilation(). Razor Runtime Compilation is obsolete in .NET 11. Unlike C# MVC projects, F# projects can't use the Razor source generator directly, so removing Runtime Compilation without additional changes causes the application to build successfully but fail when a view is requested:

InvalidOperationException: The view 'Index' was not found.

The .NET 11 F# MVC template now uses build- and publish-time Razor compilation and explicitly registers the generated <ApplicationName>.Views.dll assembly. Existing F# MVC applications that want to remove Razor Runtime Compilation should adopt the same setup.

Related product work:

  • Regression: dotnet/aspnetcore#69220
  • Runtime Compilation removal: dotnet/aspnetcore#69114
  • F# MVC template fix: dotnet/aspnetcore#69300
Proposed guidance

Clarify that newly generated .NET 11 F# MVC projects already contain this configuration. The following steps are for existing projects migrating from an earlier version of .NET.

  1. Remove the Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation package reference.

  2. Remove the call to .AddRazorRuntimeCompilation().

  3. Configure Razor compilation in the project file:

    <PropertyGroup>
  <UseRazorSourceGenerator>false</UseRazorSourceGenerator>
  <RazorCompileOnBuild>true</RazorCompileOnBuild>
  <RazorCompileOnPublish>true</RazorCompileOnPublish>
</PropertyGroup>

  4. Add MvcBuilderExtensions.fs  to the project before  Program.fs  because F# compilation order is significant:

<ItemGroup>
  <!-- Other F# source files -->
  <Compile Include="MvcBuilderExtensions.fs" />
  <Compile Include="Program.fs" />
</ItemGroup>
  1. Add MvcBuilderExtensions.fs. Its namespace must match the application's root namespace:
open System open System.IO open System.Reflection open System.Runtime.CompilerServices open System.Runtime.Loader open Microsoft.AspNetCore.Mvc.ApplicationParts open Microsoft.Extensions.DependencyInjection

[<Extension>] type MvcBuilderExtensions =
    [<Extension>]
    static member AddCompiledRazorViews(builder: IMvcBuilder) =
        let applicationAssembly = Assembly.GetExecutingAssembly()
        let viewsAssemblyName = $"{applicationAssembly.GetName().Name}.Views"
        let viewsAssemblyPath =
            Path.Combine(AppContext.BaseDirectory, $"{viewsAssemblyName}.dll")
        let loadContext =
            AssemblyLoadContext.GetLoadContext(applicationAssembly)

        let viewsAssembly =
            if File.Exists(viewsAssemblyPath) then
                loadContext.LoadFromAssemblyPath(viewsAssemblyPath)
            else
                loadContext.LoadFromAssemblyName(AssemblyName(viewsAssemblyName))

        builder.PartManager.ApplicationParts.Add(
            CompiledRazorAssemblyPart(viewsAssembly))
        builder
  1. Register the compiled views in Program.fs:
    .AddControllersWithViews()
    .AddCompiledRazorViews()

Explain that this configuration compiles Razor views during build and publish and registers the resulting views assembly with MVC. It avoids the obsolete Runtime Compilation dependency while allowing views to be discovered at runtime.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/migration/100-to-110?view=aspnetcore-10.0&tabs=visual-studio

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/migration/100-to-110.md

Document ID

3c76ffcd-7b47-b9b9-68a0-b25e375dabe9

Platform Id

542d0049-d2cb-7cae-1b4b-0d79ae30efaf

Article author

@wadepickett

Metadata
  • ID: 3c76ffcd-7b47-b9b9-68a0-b25e375dabe9
  • PlatformId: 542d0049-d2cb-7cae-1b4b-0d79ae30efaf
  • Service: aspnet-core
  • Sub-service: migration

Related Issues

Lingua principale
C#
Stelle
13.1k
Fork
24.5k
Merge medio
2g 15h
PR unite (30g)
159

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di dotnet/AspNetCore.Docs

Tutte le issue di dotnet/AspNetCore.Docs

Issue simili

Altre issue su C#

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.