Övning – Använda inbyggda mellanprogram

ASP.NET Core innehåller en uppsättning inbyggda mellanprogramskomponenter som hanterar vanliga uppgifter, till exempel routning, autentisering och HTTP-loggning. Du kan använda dessa komponenter för att lägga till funktioner i din app utan att skriva anpassade mellanprogram.

Ditt team ledde dig till att skapa en barebones-webbplats för ditt företag. Webbplatsen bör visa ett välkomstmeddelande på huvudsidan och visa en kort historik för företaget på en separat /about sida. En tidigare version av appen hade företagshistoriken /history på URL:en, så du måste omdirigera begäranden från /history till för att /about upprätthålla kompatibilitet med befintliga länkar.

Du använder den inbyggda MapGet metoden och UrlRewriter mellanprogrammet för att utföra dessa uppgifter.

Skapa en ASP.NET Core-app

Du behöver en ASP.NET Core-app för att spela rollen som ditt teams app. Nu ska vi skapa en ny ASP.NET Core-app med hjälp av C#Dev Kit-tillägget i Visual Studio Code.

1. Starta Visual Studio Code.

2. Tryck på Ctrl+Skift+P för att öppna kommandopaletten.

3. Sök efter och välj .NET: Nytt projekt....

4. Sök efter och välj ASP.NET Core Empty.

   

5. Välj eller skapa en mapp för det nya projektet.

6. Ge den nya appen namnet MyWebApp.

7. Välj Skapa projekt för att skapa projektet.

8. När det nya projektet öppnas expanderar du fönstret Solution Explorer för att visa projektfilerna.

Kör appen

Testa appen för att se till att den körs.

1. I Visual Studio Code trycker du på F5 för att skapa och köra appen.

   1. När du uppmanas till det väljer du C# som felsökningsprogram.
   2. När du uppmanas till det väljer du C#: MyWebApp [Standardkonfiguration] som startkonfiguration som ska användas.

   Det här kommandot startar appen och är värd för den på en lokal webbserver. Ett webbläsarfönster öppnas och visar "Hello, World!"

2. Stäng webbläsarfönstret och stoppa appen genom att trycka på Skift+F5 i Visual Studio Code.

Mappa slutpunkter och lägg till en URL-skrivmaskin

Nu när du har en fungerande app ska vi lägga till ett välkomstmeddelande på huvudsidan.

1. Öppna filen Program.cs .

2. På raden app.MapGet("/", () => "Hello World!"); ändrar du meddelandet "Hello World!" till "Välkommen till Contoso!"

   app.MapGet("/", () => "Welcome to Contoso!");
   

   app.MapGet() mappar en HTTP GET-begäran till en angiven sökväg. Den här funktionen i ASP.NET Core kallas slutpunktsroutning. Den här koden lägger till en gren i pipelinen. Om sökvägen för begäran är /dirigerar slutpunktsdirigeringen mellanprogram begäran till den här slutpunkten, som sedan skriver "Välkommen till Contoso!" till svaret.

3. Lägg till följande kod på nästa rad:

   app.MapGet("/about", () => "Contoso was founded in 2000.");
   

   Den här koden lägger till en annan slutpunkt. Om sökvägen för begäran är /aboutskriver slutpunkten "Vårt företag grundades år 2000" till svaret.

4. Innan den första app.MapGet()lägger du till följande kod:

   app.UseRewriter(new RewriteOptions().AddRedirect("history", "about"));
   

   Den här koden lägger till en URL-omskrivningskomponent för mellanprogram som omdirigerar begäranden från /history till /about. Metoden AddRedirect() tar två parametrar: ett mönster för reguljära uttryck som matchar sökvägen för begäran och ersättningssökvägen som ska omdirigeras till.

5. Lägg till följande direktiv överst i filen:

   using Microsoft.AspNetCore.Rewrite;
   

   Det här direktivet löser referensen RewriteOptions till klassen.

Testa ändringarna

1. Spara alla ändringar och kör appen som tidigare.
2. När webbläsarfönstret öppnas noterar du att rot-URL:en visar "Välkommen till Contoso!" Lägg till /about i URL:en och tryck på Retur. Webbläsaren bör visa "Contoso grundades 2000."
3. Ersätt /about med /history i URL:en och tryck på Retur. Webbläsaren bör omdirigeras till /about.
4. Låt appen vara igång för nästa övning.