Blazor中如何注入IUriHelper服务及在Startup.cs中添加其实现

先提个重要的小提示：在较新的Blazor版本里，IUriHelper已经被NavigationManager替代了，功能更完善。但如果你的项目还在依赖IUriHelper，下面是具体的实现步骤：

一、在Blazor组件中注入IUriHelper #

1. 构造函数注入（官方推荐方式） #

这是Blazor依赖注入的标准用法，直接在组件类的构造函数中接收IUriHelper实例：

@inject IUriHelper UriHelper
@code {
    private readonly IUriHelper _uriHelper;

    public YourComponent(IUriHelper uriHelper)
    {
        _uriHelper = uriHelper;
    }

    private void HandleNavigation()
    {
        // 获取当前绝对URI
        var currentUrl = _uriHelper.GetAbsoluteUri();
        // 导航到指定页面
        _uriHelper.NavigateTo("/about");
    }
}

嫌构造函数麻烦的话，也可以直接用@inject声明后在代码块里直接调用：

@inject IUriHelper UriHelper

<button @onclick="NavigateToHome">回到首页</button>

@code {
    private void NavigateToHome()
    {
        UriHelper.NavigateTo("/");
    }
}

2. 属性注入（兼容旧场景，不推荐） #

如果需要通过属性注入，使用[Inject]特性标记即可：

@code {
    [Inject]
    private IUriHelper UriHelper { get; set; }

    protected override void OnInitialized()
    {
        base.OnInitialized();
        // 初始化时即可访问UriHelper
        var currentPath = _uriHelper.GetAbsoluteUri();
    }
}

二、在Startup.cs中配置IUriHelper服务 #

默认情况下，Blazor框架已经自动注册了IUriHelper的官方实现，不需要手动添加。但如果要替换成自定义实现，可以按以下步骤操作：

1. 实现自定义的IUriHelper类 #

先创建一个类实现IUriHelper接口，完成所有方法的自定义逻辑：

public class CustomUriHelper : IUriHelper
{
    public string GetAbsoluteUri()
    {
        // 自定义URI获取逻辑
        return "your-custom-absolute-uri";
    }

    public void NavigateTo(string uri, bool forceLoad = false)
    {
        // 自定义导航逻辑
        Console.WriteLine($"Navigating to: {uri}");
    }

    // 实现接口要求的其他方法...
}

2. 在Startup.cs中注册自定义服务 #

打开Startup.cs，在ConfigureServices方法里替换默认的服务注册：

public void ConfigureServices(IServiceCollection services)
{
    // 用自定义实现替换默认的IUriHelper
    services.AddScoped<IUriHelper, CustomUriHelper>();

    // 其他服务注册代码...
}

补充：如果是Blazor WebAssembly项目，配置服务的入口是Program.cs，注册方式类似：

builder.Services.AddScoped<IUriHelper, CustomUriHelper>();

内容的提问来源于stack exchange，提问作者Dmitry