Menu
CoddyTech

Query-Strings

Teil des Abschnitts Minimal APIs der ASP.NET Core-Journey von Coddy. Lektion 5 von 20.

Eine Abfragezeichenfolge ist der Teil einer Adresse nach ?: Name-Wert-Paare, die durch & verbunden sind, wie in /books?author=austen&page=2. Sie wählt nicht die Route aus, sondern fügt der Anfrage Optionen hinzu. Ein Lambda-Parameter, dessen Name nicht in der Route vorkommt, wird aus der Abfragezeichenfolge gelesen.

app.MapGet("/books", (string? author, int page = 1) =>
    $"Books by {author ?? "anyone"}, page {page}");

GET /books?author=austen gibt Books by austen, page 1 zurück. Ein Parameter, der nullable ist, wie string?, oder einen Standardwert hat, ist optional. Ein einfaches string ist erforderlich: Ohne diesen Parameter antwortet ASP.NET Core mit 400 Bad Request, und das Lambda wird nie ausgeführt.

challenge icon

Aufgabe

Einfach

GET /api/recipes lernt, zu filtern: ?category=soup lässt nur die Suppen übrig.

  1. Gib in Program.cs der Lambda-Funktion von GET /api/recipes den Parameter string? category.
  2. Gib die Rezepte zurück, deren Category gleich category ist. Wenn category null ist, gib alle Rezepte zurück: recipes.Where(r => category is null || r.Category == category).

Probier es aus: Drücke „Ausführen“. GET /api/recipes?category=soup liefert die beiden Suppen mit den IDs 1 und 3 zurück. Sende GET /api/recipes: alle drei Rezepte. Sende GET /api/recipes?category=dessert: eine leere Liste, [].

Probier es selbst

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var recipes = new List<Recipe>
{
    new(1, "Tomato Soup", "soup", 25),
    new(2, "Pancakes", "breakfast", 15),
    new(3, "Lentil Soup", "soup", 40),
};

app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", () => recipes);
app.MapGet("/api/recipes/{id:int}", (int id) => recipes.FirstOrDefault(r => r.Id == id));

app.Run();

Alle Lektionen in Minimal APIs