Frissítés ASP.NET MVC-ről és webes API-ról ASP.NET Core MVC-re

Ez a cikk bemutatja, hogyan lehet ASP.NET MVC-projektet migrálni ASP.NET Core MVC-be. A folyamat során az MVC ASP.NET kapcsolódó módosításait emeli ki.

A ASP.NET MVC-ből való migrálás többlépéses folyamat. Ez a cikk a következőket ismerteti:

• Kezdeti beállítás.
• Alapszintű vezérlők és nézetek.
• Statikus tartalom.
• Ügyféloldali függőségek.

A konfiguráció és a Identity kód áttelepítésével kapcsolatban lásd a Konfiguráció áttelepítése ASP.NET Core-ra és a Hitelesítés és Identity áttelepítése ASP.NET Core-ra című témaköröket.

Prerequisites

• Visual Studio 2019 16.4 vagy újabb a ASP.NET és webfejlesztési feladatkészlettel
• .NET Core 3.1 SDK

A kezdő ASP.NET MVC-projekt létrehozása

Hozzon létre egy példát ASP.NET MVC-projektre a Visual Studióban a migráláshoz:

1. A Fájl menüben válassza a Új>Projektlehetőséget.
2. Válassza ASP.NET webalkalmazás (.NET-keretrendszer), majd a Tovább gombot.
3. Nevezze el a Projekt WebApp1 nevet, hogy a névtér egyezzen a következő lépésben létrehozott ASP.NET Core-projektel. Válassza a Create gombot.
4. Válassza az MVC-t, majd a Létrehozás opciót.

A ASP.NET Core-projekt létrehozása

Hozzon létre egy új megoldást egy új ASP.NET Core-projekttel a migráláshoz:

1. Indítsa el a Visual Studio második példányát.
2. A Fájl menüben válassza a Új>Projektlehetőséget.
3. Válassza ASP.NET Core webalkalmazást , majd válassza a Tovább gombot.
4. Az új projekt konfigurálása párbeszédpanelen adja meg a Projekt WebApp1 nevet.
5. Állítson be egy másik mappát az előző projekthez képest, hogy ugyanazt a projektnevet használhassa. Ha ugyanazt a névteret használja, könnyebben másolhat kódot a két projekt között. Válassza a Create gombot.
6. A Új ASP.NET Core-webalkalmazás létrehozása párbeszédpanelen ellenőrizze, hogy .NET Core és ASP.NET Core 3.1 van-e kiválasztva. Válassza ki a webalkalmazás (model-View-Controller) projektsablont, és válassza a Létrehozás lehetőséget.

A ASP.NET Core-hely konfigurálása MVC használatára

Az ASP.NET Core 3.0-s vagy újabb verzióiban a .NET-keretrendszer már nem támogatott cél keretrendszer. A projektnek meg kell céloznia a .NET Core-t. A ASP.NET Core megosztott keretrendszere, amely az MVC-t is tartalmazza, a .NET Core futtatókörnyezet telepítésének része. A megosztott keretrendszerre a rendszer automatikusan hivatkozik, amikor az Microsoft.NET.Sdk.Web SDK-t használja a projektfájlban:

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

További információ: Keretrendszer-referencia.

A ASP.NET Core-ban az Startup osztály:

• Lecseréli a elemet Global.asax.
• Az összes alkalmazásindítási feladatot kezeli.

További információért lásd: Alkalmazás indítása ASP.NET Core.

A ASP.NET Core-projektben nyissa meg a Startup.cs fájlt:

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-alkalmazásoknak csatlakozniuk kell a köztes szoftver keretrendszerfunkcióihoz. Az előző sablon által létrehozott kód a következő szolgáltatásokat és köztes szoftvereket adja hozzá:

• A AddControllersWithViews bővítménymetódus regisztrálja az MVC szolgáltatás támogatását a vezérlők, az API-val kapcsolatos funkciók és nézetek esetében. További információ az MVC szolgáltatásregisztrációs lehetőségeiről: MVC szolgáltatásregisztráció
• A UseStaticFiles bővítménymetódus hozzáadja a statikus fájlkezelőt Microsoft.AspNetCore.StaticFiles. A UseStaticFiles bővítménymetódust előbb UseRoutingkell meghívni. További információért lásd: Statikus fájlok az ASP.NET Core-ban.
• A UseRouting bővítménymetódus útválasztást ad hozzá. További információkért lásd: Útvonalkezelés az ASP.NET Core-ban.

Ez a meglévő konfiguráció tartalmazza az MVC-projekt ASP.NET példa áttelepítéséhez szükséges elemet. Az ASP.NET Core köztes szoftver beállításairól további információt a ASP.NET Core alkalmazás indítása című témakörben talál.

Vezérlők és nézetek migrálása

Az ASP.NET Core projektben egy új üres vezérlő-osztály és nézet-osztály kerül hozzáadásra, ugyanazokat a neveket használva, mint a vezérlő- és nézetosztályok bármely ASP.NET MVC projektben, ahonnan migrál.

Az ASP.NET Core WebApp1 projekt már tartalmaz egy minimális példavezérlőt és nézetet ugyanazzal a névvel, mint az ASP.NET MVC-projektet. Ezek tehát az ASP.NET MVC-vezérlő és az ASP.NET MVC WebApp1 projektből migrálandó nézetek helyőrzőiként fognak szolgálni.

1. Másolja a metódusokat az ASP.NET MVC-ből HomeController az új ASP.NET Core HomeController metódusok helyére. Nincs szükség a műveleti módszerek visszatérési típusának módosítására. Az ASP.NET MVC beépített sablonjának vezérlőműveleti metódusának visszatérési típusa ActionResult; az ASP.NET Core MVC esetében a műveleti metódusok IActionResult-t adnak vissza. ActionResult implementálja IActionResult.
2. A ASP.NET Core-projektben kattintson a jobb gombbal a Nézetek/Homekönyvtár elemre, és válassza aMeglévő elem> lehetőséget.
3. A Meglévő elem hozzáadása párbeszédpanelen lépjen az ASP.NET MVC WebApp1-projektNézetek/Home könyvtárába.
4. Jelölje ki a About.cshtml, Contact.cshtmlés Index.cshtmlRazor tekintse meg a fájlokat, majd válassza a Hozzáadás lehetőséget, és cserélje le a meglévő fájlokat.

További információ: Kérelmek kezelése vezérlőkkel ASP.NET Core MVC-ben és nézetek a ASP.NET Core MVC-ben.

Az egyes metódusok tesztelése

Minden vezérlővégpont tesztelhető, azonban az elrendezés és a stílusok a dokumentum későbbi részében is szerepelnek.

1. Futtassa a ASP.NET Core alkalmazást.
2. Hívja meg a megjelenített nézeteket a böngészőből a futó ASP.NET Core-alkalmazásban, ha az aktuális portszámot a ASP.NET Core-projektben használt portszámra cseréli. Például: https://localhost:44375/home/about.

Statikus tartalom migrálása

A ASP.NET MVC 5-ös vagy korábbi verziójában a statikus tartalom a webprojekt gyökérkönyvtárából lett üzemeltetve, és kiszolgálóoldali fájlokkal volt összekapcsolva. A ASP.NET Core-ban a statikus fájlok a projekt webes gyökérkönyvtárában vannak tárolva. Az alapértelmezett könyvtár {content root}/wwwroot, de módosítható. További információért lásd: Statikus fájlok az ASP.NET Core-ban.

Másolja a statikus tartalmat az ASP.NET MVC WebApp1 projektből a wwwroot ASP.NET Core WebApp1 projekt könyvtárába:

1. A ASP.NET Core-projektben kattintson a jobb gombbal a könyvtárra, és válassza a wwwrootMeglévő elem> lehetőséget.
2. A Meglévő elem hozzáadása párbeszédpanelen lépjen az ASP.NET MVC WebApp1 projekthez.
3. Jelölje ki a favicon.ico fájlt, majd válassza a Hozzáadás lehetőséget, és cserélje le a meglévő fájlt.

Az elrendezésfájlok migrálása

Másolja a ASP.NET MVC-projektelrendezési fájlokat a ASP.NET Core-projektbe:

1. A ASP.NET Core-projektben kattintson a jobb gombbal a könyvtárra, és válassza a ViewsMeglévő elem> lehetőséget.
2. A Meglévő elem hozzáadása párbeszédpanelen keresse meg az ASP.NET MVC WebApp1 projekt könyvtárát Views .
3. Jelölje ki a fájlt, majd válassza a _ViewStart.cshtmlHozzáadás lehetőséget.

Másolja a ASP.NET MVC-projekt megosztott elrendezési fájljait a ASP.NET Core-projektbe:

1. A ASP.NET Core-projektben kattintson a jobb gombbal a könyvtárra, és válassza a Views/SharedMeglévő elem> lehetőséget.
2. A Meglévő elem hozzáadása párbeszédpanelen keresse meg az ASP.NET MVC WebApp1 projekt könyvtárát Views/Shared .
3. Jelölje ki a _Layout.cshtml fájlt, majd válassza a Hozzáadás lehetőséget, és cserélje le a meglévő fájlt.

A ASP.NET Core-projektben nyissa meg a _Layout.cshtml fájlt. Végezze el a következő módosításokat az alább látható befejezett kódnak megfelelően:

Frissítse a Bootstrap CSS beillesztését, hogy megfeleljen az alábbi befejezett kódnak.

1. Cserélje le @Styles.Render("~/Content/css") a <link> betöltendő bootstrap.css elemre (lásd alább).
2. Távolítsa el @Scripts.Render("~/bundles/modernizr").

A Bootstrap CSS beépítésének kész helyettesítő jelölése.

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

Frissítse a jQuery és a Bootstrap JavaScript beillesztését, hogy megfeleljen az alábbi befejezett kódnak:

1. Cserélje le a @Scripts.Render("~/bundles/jquery") elemet egy <script> elemre (lásd alább).
2. Cserélje le a @Scripts.Render("~/bundles/bootstrap") elemet egy <script> elemre (lásd alább).

A jQuery és a Bootstrap JavaScript helyettesítő jelölésének befejezése:

<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>

A frissített _Layout.cshtml fájl alább látható:

<!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>

A webhely megtekintése a böngészőben. A megjelenítésnek a várt stílusokkal kell történnie.

A kötegelés és a kicsinyítés beállítása

ASP.NET Core kompatibilis számos nyílt forráskódú csomagküldő és minification megoldással, például a WebOptimizerrel és más hasonló kódtárakkal. ASP.NET Core nem biztosít natív kötegelési és kicsinyítési megoldást. A csomagolás és a kicsinyítés konfigurálásáról további információk a Csomagolás és kicsinyítés oldalon találhatók.

HTTP 500-hibák megoldása

Számos probléma okozhat OLYAN HTTP 500-hibaüzenetet, amely nem tartalmaz információt a probléma forrásáról. Ha például a Views/_ViewImports.cshtml fájl olyan névteret tartalmaz, amely nem létezik a projektben, HTTP 500-hiba jön létre. Alapértelmezés szerint a ASP.NET Core-alkalmazásokban a UseDeveloperExceptionPage bővítmény hozzáadódik a IApplicationBuilder bővítményhez, és akkor lesz végrehajtva, amikor a környezet fejlesztés. Ennek részletes leírása a következő kódban található:

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 HTTP 500 hibaválaszokká alakítja a kezeletlen kivételeket. Ezek a válaszok általában nem tartalmazzák a hiba részleteit, hogy megakadályozzák a kiszolgálóval kapcsolatos bizalmas információk közzétételét. További információ: Fejlesztői kivételoldal.

Következő lépések

• <identity.md>

További erőforrások

• ASP.NET Core Blazor
• Tag Segédprogramok az ASP.NET Core-ban