Autorouting in pure and hybrid mode

Sitefinity’s URL handling capabilities are built on the ASP.NET Routing Engine (formerly known as the ASP.NET MVC Routing Engine). When you are working in pure or hybrid mode, the route is picked up by the page. The page then constructs dynamically new routes for the MVC based widgets, which may or may not respond to it. If at least one of the widgets can handle the route data, page will render - otherwise you'll get 404. In a word - you must use route registrations only for classic MVC (side by side apps) mode. For more information about the different modes, read For developers: MVC modes.

Sample action methods and URLs for invoking them

For example, take the following action:

In order to invoke it you will need to specify both parameters in the URL - /<page url>/details/<page>/<name>. The parameters should be in the same order as they are in the action method declaration. If the parameters are swapped (/<page url>/details/<name>/<page>) the invocation will result in displaying an error.

When the ActionLink helper method is used, the order of the parameters is not important, as in the following sample:

Both invocations will generate correct URL - /<page url>/Details/3/Some name.

Note: If any of the required parameters is missing, the generated URL will have no parameters specified and will not be correct - /<page url>/Details/, because no action can be found with the provided parameters.

To mark any of the parameters as not required, you need to set default value for it or to make it nullable (only for value types). For example, the following URL - /<page url>/Details/3, will successfully match and execute the action with declaration:

In order to skip both parameters, you must declare the action in one of the following ways:

NOTE: All optional parameters must be after the required ones.

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?