-
Notifications
You must be signed in to change notification settings - Fork 25.3k
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.
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
RP conventions topic+sample updates #8523
Conversation
22ba661
to
60109ec
Compare
Updates Updates
9430fd6
to
d23e1ed
Compare
* When routes have the same `Order`, the most specific route is matched first followed by less specific routes. | ||
* When routes with the same `Order` and the same number of parameters match a request URL, routes are processed in the order that they're added to the <xref:Microsoft.AspNetCore.Mvc.ApplicationModels.PageConventionCollection>. | ||
|
||
If possible, avoid depending on an established route processing order. Generally, routing selects the correct route with URL matching. If you must set route `Order` properties to route requests correctly, the app's routing scheme is probably confusing to clients and fragile to maintain. Seek to simplify the app's routing scheme. The sample app requires an explicit route processing order to demonstrate several routing scenarios using a single app. However, you should attempt to avoid the practice of setting route `Order` in production apps. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This section all seems pretty good. If there's details about this in the regular routing section it might be helpful to link it. This is a shared implementation with regular routing.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, there's one spot in routing where this is discussed, and there is some duplication. Of course, PageCollectionConvention
isn't discussed over there. I'll take another look at this in a few minutes and see about cross-linking both ways (just in case someone looking for RP content lands over there).
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Update the ms.date value on each of the Markdown files you touched.
Fixes #6173
Internal Review Topic
@rynowak This follows our discussion on aspnet/Mvc#8385.
Thanks again to @user135711 for surfacing the issues.