daohualiuxiang
/
AspNetCore.Docs
mirror of https://github.com/dotnet/AspNetCore.Docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Route data on the HttpContext scenario (#12913)

pull/12916/head
Luke Latham 2019-06-17 17:24:31 -05:00 committed by GitHub
parent 035fdc8ee8
commit c319201b6e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
aspnetcore/fundamentals/routing.md
View File

@ -4,7 +4,7 @@ author: rick-anderson
description: Discover how ASP.NET Core routing is responsible for mapping request URIs to endpoint selectors and dispatching incoming requests to endpoints.
ms.author: riande
ms.custom: mvc
ms.date: 02/13/2019
ms.date: 06/17/2019
uid: fundamentals/routing
---
# Routing in ASP.NET Core
@ -135,6 +135,21 @@ Routing is connected to the [middleware](xref:fundamentals/middleware/index) pip
URL matching is the process by which routing dispatches an incoming request to an *endpoint*. This process is based on data in the URL path but can be extended to consider any data in the request. The ability to dispatch requests to separate handlers is key to scaling the size and complexity of an app.
::: moniker-end
::: moniker range=">= aspnetcore-3.0"
When a Routing Middleware executes, it sets an endpoint (`Endpoint`) and route values to a feature on the <xref:Microsoft.AspNetCore.Http.HttpContext>. For the current request:
* Calling `HttpContext.GetEndpoint` gets the endpoint.
* `HttpRequest.RouteValues` gets the collection of route values.
Middleware running after the Routing Middleware can see the endpoint and take action. For example, an Authorization Middleware can interrogate the endpoint's metadata collection for an authorization policy. After all of the middleware in the request processing pipeline is executed, the selected endpoint's delegate is invoked.
::: moniker-end
::: moniker range=">= aspnetcore-2.2"
The routing system in endpoint routing is responsible for all dispatching decisions. Since the middleware applies policies based on the selected endpoint, it's important that any decision that can affect dispatching or the application of security policies is made inside the routing system.
When the endpoint delegate is executed, the properties of [RouteContext.RouteData](xref:Microsoft.AspNetCore.Routing.RouteContext.RouteData) are set to appropriate values based on the request processing performed thus far.