Skip to content

Middleware article overhaul #36616

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
guardrex wants to merge 15 commits into
base: main
Choose a base branch
from
Open

Middleware article overhaul #36616

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
6df59db
Middleware article overhaul
guardrex Jan 13, 2026
bece66d
Updates
guardrex Jan 13, 2026
dc1e4f1
Updates
guardrex Jan 13, 2026
978709c
Updates
guardrex Jan 14, 2026
1c13aae
Updates
guardrex Jan 15, 2026
82ab194
Remove Mermaid files
guardrex Jan 15, 2026
e50cff0
Updates
guardrex Jan 15, 2026
bf4bce6
Updates
guardrex Jan 15, 2026
f6c8654
Updates
guardrex Jan 16, 2026
2df63d6
Updates
guardrex Jan 16, 2026
61d9cfc
Updates
guardrex Jan 16, 2026
a9d1dbf
Updates
guardrex Jan 20, 2026
dc8790a
Updates
guardrex Jan 22, 2026
fd72935
Updates
guardrex Jan 23, 2026
472d0dd
Updates
guardrex Feb 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion aspnetcore/blazor/host-and-deploy/app-base-path.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -218,7 +218,7 @@ In many hosting scenarios, the relative URL path to the app is the root of the a
:::moniker-end

> [!NOTE]
> When using <xref:Microsoft.AspNetCore.Builder.WebApplication> (see <xref:migration/50-to-60#new-hosting-model>), [`app.UseRouting`](xref:Microsoft.AspNetCore.Builder.EndpointRoutingApplicationBuilderExtensions.UseRouting%2A) must be called after <xref:Microsoft.AspNetCore.Builder.UsePathBaseExtensions.UsePathBase%2A> so that the Routing Middleware can observe the modified path before matching routes. Otherwise, routes are matched before the path is rewritten by <xref:Microsoft.AspNetCore.Builder.UsePathBaseExtensions.UsePathBase%2A> as described in the [Middleware Ordering](xref:fundamentals/middleware/index#order) and [Routing](xref:fundamentals/routing) articles.
> When using <xref:Microsoft.AspNetCore.Builder.WebApplication> (see <xref:migration/50-to-60#new-hosting-model>), [`app.UseRouting`](xref:Microsoft.AspNetCore.Builder.EndpointRoutingApplicationBuilderExtensions.UseRouting%2A) must be called after <xref:Microsoft.AspNetCore.Builder.UsePathBaseExtensions.UsePathBase%2A> so that the Routing Middleware can observe the modified path before matching routes. Otherwise, routes are matched before the path is rewritten by <xref:Microsoft.AspNetCore.Builder.UsePathBaseExtensions.UsePathBase%2A> as described in the <xref:fundamentals/middleware/index#middleware-order> and <xref:fundamentals/routing>.

Don't prefix links throughout the app with a forward slash. Either avoid the use of a path segment separator or use dot-slash (`./`) relative path notation:

Expand Down
4 changes: 0 additions & 4 deletions aspnetcore/data/ef-rp/update-related-data.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,8 +46,6 @@ Update `Pages/Courses/Create.cshtml.cs` with the following code:

[!code-csharp[](intro/samples/cu50/Pages/Courses/Create.cshtml.cs?highlight=7,18,27-41)]

[!INCLUDE[loc comments](~/includes/code-comments-loc.md)]

The preceding code:

* Derives from `DepartmentNamePageModel`.
Expand Down Expand Up @@ -269,8 +267,6 @@ Update `Pages/Courses/Create.cshtml.cs` with the following code:

[!code-csharp[](intro/samples/cu30/Pages/Courses/Create.cshtml.cs?highlight=7,18,27-41)]

[!INCLUDE[about the series](~/includes/code-comments-loc.md)]

The preceding code:

* Derives from `DepartmentNamePageModel`.
Expand Down
4 changes: 2 additions & 2 deletions aspnetcore/fundamentals/app-state.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ The following code shows how to set up the in-memory session provider with a def

The preceding code sets a short timeout to simplify testing.

The order of middleware is important. Call `UseSession` after `UseRouting` and before `MapRazorPages` and `MapDefaultControllerRoute` . See [Middleware Ordering](xref:fundamentals/middleware/index#order).
The order of middleware is important. Call `UseSession` after `UseRouting` and before `MapRazorPages` and `MapDefaultControllerRoute` . See [Middleware Ordering](xref:fundamentals/middleware/index#middleware-order).
Copy link
Contributor

@tdykstra tdykstra Feb 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The order of middleware is important. Call `UseSession` after `UseRouting` and before `MapRazorPages` and `MapDefaultControllerRoute` . See [Middleware Ordering](xref:fundamentals/middleware/index#middleware-order).
The order of middleware is important. Call `UseSession` after `UseRouting` and before `MapRazorPages` and `MapDefaultControllerRoute`. See [Middleware Ordering](xref:fundamentals/middleware/index#middleware-order).


[HttpContext.Session](xref:Microsoft.AspNetCore.Http.HttpContext.Session) is available after session state is configured.

Expand Down Expand Up @@ -376,7 +376,7 @@ The following code shows how to set up the in-memory session provider with a def

The preceding code sets a short timeout to simplify testing.

The order of middleware is important. Call `UseSession` after `UseRouting` and before `UseEndpoints`. See [Middleware Ordering](xref:fundamentals/middleware/index#order).
The order of middleware is important. Call `UseSession` after `UseRouting` and before `UseEndpoints`. For more information, see <xref:fundamentals/middleware/index#middleware-order>.

[HttpContext.Session](xref:Microsoft.AspNetCore.Http.HttpContext.Session) is available after session state is configured.

Expand Down
1 change: 0 additions & 1 deletion aspnetcore/fundamentals/http-requests.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -890,7 +890,6 @@ Typed clients:
A typed client accepts an `HttpClient` parameter in its constructor:

:::code language="csharp" source="http-requests/samples/3.x/HttpClientFactorySample/GitHub/GitHubService.cs" id="snippet1" highlight="5":::
[!INCLUDE[about the series](~/includes/code-comments-loc.md)]

In the preceding code:

Expand Down
2 changes: 0 additions & 2 deletions aspnetcore/fundamentals/localization/includes/localization35.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -255,8 +255,6 @@ The current culture on a request is set in the localization [Middleware](xref:fu

[!code-csharp[](~/fundamentals/localization/sample/3.x/Localization/Startup.cs?name=snippet2)]

[!INCLUDE[about the series](~/includes/code-comments-loc.md)]

`UseRequestLocalization` initializes a `RequestLocalizationOptions` object. On every request the list of `RequestCultureProvider` in the `RequestLocalizationOptions` is enumerated and the first provider that can successfully determine the request culture is used. The default providers come from the `RequestLocalizationOptions` class:

1. `QueryStringRequestCultureProvider`
Expand Down
1,105 changes: 982 additions & 123 deletions aspnetcore/fundamentals/middleware/index.md
View file
Open in desktop

Large diffs are not rendered by default.

30 changes: 0 additions & 30 deletions aspnetcore/fundamentals/middleware/index/includes/VertGraph.md
View file
Open in desktop

This file was deleted.

Loading