How to use UriHelper or NavigationManager in .NET Core 3.0 & Blazor?

This post was most recently updated on November 4th, 2019.

2 min read.

Just a quick piece of documentation, as this piece of code has changed in different versions of .NET Core 3.0 so far a few times. Need to have things like this written down somewhere!

UriHelper / NavigationManager with .NET Core 3.0

Table of Contents

Both of these helper libraries do essentially the same thing: navigate/browse/redirect the user to a different address, component, page or view in or by your web app. What you normally use this library for is exactly the same in all versions I’ve worked with, anyway, and that goes as follows:

// to redirect the user, do something like this:
uriHelper.NavigateTo("/yourPage"); // to do a dynamic refresh with injected UriHelper

navMan.NavigateTo("/yourPage", true); // to also force page refresh instead of a dynamic load with injected NavigationManager

See below on how to inject these dependencies to your pages and views!

< .NET Core 3.0 preview 7

Before preview 7, the UriHelper would be available from namespace Microsoft.AspNetCore.Blazor.Services. I suppose that made sense originally, if the services was to be used by just Blazor? This is how to use it:


@inject Microsoft.AspNetCore.Blazor.Services.IUriHelper UriHelper

.NET Core 3.0 preview 7

In .NET Core 3.0 preview 7, the UriHelper library’s (used in Blazor) namespace and usage has changed a bit.

Instead, it is now out of the Blazor namespace and in the Components.Services namespace.

@inject Microsoft.AspNetCore.Components.Services.IUriHelper UriHelper

.NET Core 3.0 preview 8

Yes, it’s changed again. Now it’s out of the “Services” namespace.

@inject Microsoft.AspNetCore.Components.IUriHelper UriHelper

.NET Core 3.0 preview 9 +

Okay, so I recall this has been the same in preview 9 and the GA version.

@inject NavigationManager NavigationManager

Yeah ok, so that’s that. Short and sweet for a change :)

Antti K. Koskela

Developer / Speaker / Consultant at Koskila / Precio Fishbone / Norppandalotti Software Co / Alter - Experience Ideas Ltd

Antti Koskela is a proud digital native nomadic millennial full stack developer (is that enough funny buzzwords? That's definitely enough funny buzzwords!), who works as Solutions Architect for Precio Fishbone, building delightful Digital Workplaces.

He's been a developer from 2004 (starting with PHP and Java), and he's been working on .NET projects, Azure, Office 365, SharePoint and a lot of other stuff. He's also Microsoft MVP for Office Development.

This is his personal professional (e.g. professional, but definitely personal) blog.

Latest posts by Antti K. Koskela (see all)