Upgrade von ASP.NET MVC und Web-API auf ASP.NET Core MVC

In diesem Artikel wird gezeigt, wie Sie mit der Migration eines ASP.NET MVC-Projekts zu ASP.NET Core MVC beginnen. Dabei werden verwandte Änderungen von ASP.NET MVC hervorgehoben.

Die Migration von ASP.NET MVC ist ein mehrstufiger Prozess. In diesem Artikel wird Folgendes behandelt:

• Anfängliches Setup.
• Grundlegende Controller und Ansichten
• Statischer Inhalt.
• Clientseitige Abhängigkeiten.

Informationen zum Migrieren von Konfiguration und Identity Code finden Sie unter Migrieren der Konfiguration zu ASP.NET Core und Migrieren der Authentifizierung und Identity zum ASP.NET Core.

Prerequisites

• Visual Studio 2019 16.4 oder höher mit der Arbeitsauslastung für ASP.NET und Webentwicklung
• .NET Core 3.1 SDK

Erstellen des Startprojekts ASP.NET MVC

Erstellen Sie ein Beispiel ASP.NET MVC-Projekt in Visual Studio zum Migrieren:

1. Klicken Sie im Menü Datei auf Neu>Projekt.
2. Wählen Sie ASP.NET Webanwendung (.NET Framework) und dann "Weiter" aus.
3. Benennen Sie das Projekt WebApp1 , damit der Namespace dem im nächsten Schritt erstellten ASP.NET Core-Projekt entspricht. Wählen Sie "Erstellen" aus.
4. Wählen Sie MVC und dann "Erstellen" aus.

Erstellen des ASP.NET Core-Projekts

Erstellen Sie eine neue Lösung mit einem neuen ASP.NET Core-Projekt, zu dem Sie migrieren möchten:

1. Starten Sie eine zweite Instanz von Visual Studio.
2. Klicken Sie im Menü Datei auf Neu>Projekt.
3. Wählen Sie ASP.NET Core-Webanwendung und dann "Weiter" aus.
4. Benennen Sie im Dialogfeld " Neues Projekt konfigurieren " das Projekt "WebApp1".
5. Legen Sie den Speicherort auf ein anderes Verzeichnis als das vorherige Projekt fest, um denselben Projektnamen zu verwenden. Die Verwendung desselben Namespace erleichtert das Kopieren von Code zwischen den beiden Projekten. Wählen Sie "Erstellen" aus.
6. Vergewissern Sie sich im Dialogfeld Erstellen eines neuen ASP.NET Core-Webanwendungs-, dass .NET Core und ASP.NET Core 3.1- ausgewählt sind. Wählen Sie die Projektvorlage " Webanwendung" (Modell-View-Controller) und dann "Erstellen" aus.

Konfigurieren der ASP.NET Core-Website für die Verwendung von MVC

In ASP.NET Core 3.0- oder höher-Projekten ist .NET Framework kein unterstütztes Zielframework mehr. Ihr Projekt muss .NET Core als Ziel festlegen. Das ASP.NET core shared framework, das MVC enthält, ist Teil der .NET Core-Laufzeitinstallation. Auf das freigegebene Framework wird automatisch verwiesen, wenn das Microsoft.NET.Sdk.Web SDK in der Projektdatei verwendet wird:

<Project Sdk="Microsoft.NET.Sdk.Web">

Weitere Informationen finden Sie unter Framework-Referenz.

In ASP.NET Core ist die Klasse Startup:

• Global.asax Ersetzt.
• Behandelt alle App-Startaufgaben.

Weitere Informationen finden Sie unter Anwendungsstart in ASP.NET Core.

Öffnen Sie im ASP.NET Core-Projekt die Startup.cs Datei:

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllersWithViews();
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error");
            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
            app.UseHsts();
        }
        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllerRoute(
                name: "default",
                pattern: "{controller=Home}/{action=Index}/{id?}");
        });
    }
}

ASP.NET Core-Apps müssen sich für Frameworkfeatures mit Middleware entscheiden. Der vorherige vom Vorlagen generierte Code fügt die folgenden Dienste und Middleware hinzu:

• Die AddControllersWithViews Erweiterungsmethode registriert die MVC-Dienstunterstützung für Controller, API-bezogene Features und Ansichten. Weitere Informationen zu MVC-Dienstregistrierungsoptionen finden Sie unter MVC-Dienstregistrierung
• Die UseStaticFiles Erweiterungsmethode fügt den statischen Dateihandler Microsoft.AspNetCore.StaticFileshinzu. Die UseStaticFiles Erweiterungsmethode muss vor UseRoutingaufgerufen werden. Weitere Informationen finden Sie unter Statische Dateien in ASP.NET Core.
• Die UseRouting Erweiterungsmethode fügt Routing hinzu. Weitere Informationen finden Sie unter Routing in ASP.NET Core.

Diese vorhandene Konfiguration enthält, was zum Migrieren des Beispiels ASP.NET MVC-Projekts erforderlich ist. Weitere Informationen zu ASP.NET Core Middleware-Optionen finden Sie im App-Start in ASP.NET Core.

Migrieren von Controllern und Ansichten

Im ASP.NET Core-Projekt wird eine neue leere Controllerklasse und Ansichtsklasse hinzugefügt, die als Platzhalter mit denselben Namen wie die Controller- und Ansichtsklassen in jedem ASP.NET MVC-Projekt verwendet werden, aus dem migriert werden soll.

Das ASP.NET Core WebApp1-Projekt enthält bereits einen minimalen Beispielcontroller und eine Ansicht mit demselben Namen wie das ASP.NET MVC-Projekts. Diese dienen also als Platzhalter für den ASP.NET MVC-Controller und -Ansichten, die aus dem ASP.NET MVC WebApp1-Projekt migriert werden sollen.

1. Kopieren Sie die Methoden aus dem ASP.NET MVC HomeController , um die neuen ASP.NET Core-Methoden HomeController zu ersetzen. Es ist nicht erforderlich, den Rückgabetyp der Aktionsmethoden zu ändern. Der Rückgabetyp der eingebauten Controlleraktionsmethode der ASP.NET-MVC-Vorlage ist ActionResult; in ASP.NET Core MVC geben die Aktionsmethoden stattdessen IActionResult zurück. ActionResult implementiert IActionResult.
2. Klicken Sie im ASP.NET Core-Projekt mit der rechten Maustaste auf das Verzeichnis "Ansichten/HomeVerzeichnis", und wählen Sie "Vorhandenes Element> aus.
3. Navigieren Sie im Dialogfeld "Vorhandenes Element hinzufügen" zum AnsichtenVerzeichnis des ASP.NET MVC Home.
4. Wählen Sie die Ansichtsdateien About.cshtml, Contact.cshtml und Index.cshtmlRazor aus, dann wählen Sie Hinzufügen aus, um die vorhandenen Dateien zu ersetzen.

Weitere Informationen finden Sie unter Behandeln von Anforderungen mit Controllern in ASP.NET Core MVC und Views in ASP.NET Core MVC.

Jede Methode testen

Jeder Controllerendpunkt kann jedoch getestet werden, Layout und Formatvorlagen werden später im Dokument behandelt.

1. Führen Sie die ASP.NET Core-App aus.
2. Rufen Sie die gerenderten Ansichten aus dem Browser auf der ausgeführten ASP.NET Core-App auf, indem Sie die aktuelle Portnummer durch die portnummer ersetzen, die im ASP.NET Core-Projekt verwendet wird. Beispiel: https://localhost:44375/home/about.

Migrieren statischer Inhalte

In ASP.NET MVC 5 oder früheren Versionen wurde statischer Inhalt aus dem Stammverzeichnis des Webprojekts gehostet und mit serverseitigen Dateien vermischt. In ASP.NET Core werden statische Dateien im Webstammverzeichnis des Projekts gespeichert. Das Standardverzeichnis ist {content root}/wwwroot, kann aber geändert werden. Weitere Informationen finden Sie unter Statische Dateien in ASP.NET Core.

Kopieren Sie den statischen Inhalt aus dem ASP.NET MVC WebApp1-Projekt in das wwwroot Verzeichnis im ASP.NET Core WebApp1-Projekt :

1. Klicken Sie im ASP.NET Core-Projekt mit der rechten Maustaste auf das wwwroot Verzeichnis, und wählen Sie "Vorhandenes Element> aus.
2. Navigieren Sie im Dialogfeld " Vorhandenes Element hinzufügen " zum ASP.NET MVC WebApp1-Projekts .
3. Wählen Sie die favicon.ico Datei und dann "Hinzufügen" aus, und ersetzen Sie die vorhandene Datei.

Migrieren der Layoutdateien

Kopieren Sie die ASP.NET MVC-Projektlayoutdateien in das ASP.NET Core-Projekt:

1. Klicken Sie im ASP.NET Core-Projekt mit der rechten Maustaste auf das Views Verzeichnis, und wählen Sie "Vorhandenes Element> aus.
2. Navigieren Sie im Dialogfeld "Vorhandenes Element hinzufügen" zum Verzeichnis des ASP.NET MVC WebApp1-ProjektsViews.
3. Wählen Sie die _ViewStart.cshtml Datei und dann "Hinzufügen" aus.

Kopieren Sie die freigegebenen Layout-Dateien des ASP.NET MVC-Projekts in das ASP.NET Core-Projekt.

1. Klicken Sie im ASP.NET Core-Projekt mit der rechten Maustaste auf das Views/Shared Verzeichnis, und wählen Sie "Vorhandenes Element> aus.
2. Navigieren Sie im Dialogfeld "Vorhandenes Element hinzufügen" zum Verzeichnis des ASP.NET MVC WebApp1-ProjektsViews/Shared.
3. Wählen Sie die _Layout.cshtml Datei und dann "Hinzufügen" aus, und ersetzen Sie die vorhandene Datei.

Öffnen Sie die Datei _Layout.cshtml im ASP.NET Core-Projekt. Nehmen Sie die folgenden Änderungen vor, um mit dem unten gezeigten abgeschlossenen Code übereinzugleichen:

Aktualisieren Sie die Bootstrap-CSS-Inklusion so, dass sie dem abgeschlossenen Code unten entspricht:

1. Ersetzen Sie @Styles.Render("~/Content/css") durch ein <link> Element, um bootstrap.css zu laden (siehe unten).
2. Entfernen Sie @Scripts.Render("~/bundles/modernizr").

Das vollständige Ersatzmarkup für die Bootstrap-CSS-Einbindung:

<link rel="stylesheet"
    href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.css"
    integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u"
    crossorigin="anonymous">

Aktualisieren Sie die jQuery- und Bootstrap-JavaScript-Inklusion so, dass sie dem abgeschlossenen Code unten entspricht:

1. Ersetzen Sie @Scripts.Render("~/bundles/jquery") durch ein <script>-Element (siehe unten).
2. Ersetzen Sie @Scripts.Render("~/bundles/bootstrap") durch ein <script>-Element (siehe unten).

Das vollständige Ersetzungsmarkup für die Einbindung von jQuery und Bootstrap JavaScript:

<script src="https://code.jquery.com/jquery-3.3.1.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.js"
    integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>

Die aktualisierte _Layout.cshtml Datei wird unten angezeigt:

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>@ViewBag.Title - My ASP.NET Application</title>
    <link rel="stylesheet"
          href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.css"
          integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u"
          crossorigin="anonymous">
</head>
<body>
    <div class="navbar navbar-inverse navbar-fixed-top">
        <div class="container">
            <div class="navbar-header">
                <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                    <span class="icon-bar"></span>
                </button>
                @Html.ActionLink("Application name", "Index", "Home", new { area = "" }, new { @class = "navbar-brand" })
            </div>
            <div class="navbar-collapse collapse">
                <ul class="nav navbar-nav">
                    <li>@Html.ActionLink("Home", "Index", "Home")</li>
                    <li>@Html.ActionLink("About", "About", "Home")</li>
                    <li>@Html.ActionLink("Contact", "Contact", "Home")</li>
                </ul>
            </div>
        </div>
    </div>
    <div class="container body-content">
        @RenderBody()
        <hr />
        <footer>
            <p>&copy; @DateTime.Now.Year - My ASP.NET Application</p>
        </footer>
    </div>

    <script src="https://code.jquery.com/jquery-3.3.1.js"></script>
    <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.js"
            integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
    @RenderSection("scripts", required: false)
</body>
</html>

Zeigen Sie die Website im Browser an. Sie sollte mit den erwarteten Formatvorlagen gerendert werden.

Konfigurieren von Bündelung und Minimierung

ASP.NET Core ist mit mehreren Open Source-Bündelungs- und Minifizierungslösungen wie WebOptimizer und anderen ähnlichen Bibliotheken kompatibel. ASP.NET Core bietet keine native Bündelungs- und Minimierungslösung. Informationen zum Konfigurieren von Bündelung und Minimierung finden Sie unter "Bundling and Minification".

Beheben von HTTP 500-Fehlern

Es gibt viele Probleme, die eine HTTP 500-Fehlermeldung verursachen können, die keine Informationen zur Quelle des Problems enthält. Wenn die Views/_ViewImports.cshtml Datei beispielsweise einen Namespace enthält, der im Projekt nicht vorhanden ist, wird ein HTTP 500-Fehler generiert. Standardmäßig wird in ASP.NET Core-Apps die UseDeveloperExceptionPage Erweiterung der IApplicationBuilder hinzugefügt und ausgeführt, wenn die Umgebung Entwicklung ist. Dies ist im folgenden Code beschrieben:

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllersWithViews();
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error");
            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
            app.UseHsts();
        }
        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllerRoute(
                name: "default",
                pattern: "{controller=Home}/{action=Index}/{id?}");
        });
    }
}

ASP.NET Core konvertiert unbehandelte Ausnahmen in HTTP 500-Fehlerantworten. Normalerweise sind Fehlerdetails in diesen Antworten nicht enthalten, um die Offenlegung potenziell vertraulicher Informationen über den Server zu verhindern. Weitere Informationen finden Sie in der Seite „Entwickler-Ausnahmeseite“.

Nächste Schritte

• <identity.md>

Weitere Ressourcen

• ASP.NET Core Blazor
• Taghilfsprogramme in ASP.NET Core