Blazor Server控制器中如何正确使用查询字符串？

你遇到的问题是误用了Blazor组件的参数特性，ASP.NET Core API控制器有独立的参数绑定规则，具体修正方案如下：

问题根源 #

[Parameter]和[SupplyParameterFromQuery]是Blazor组件专用的参数接收特性，不适用于ASP.NET Core API控制器，因此无法正确绑定查询字符串参数。

修正方案 #

方案1：将查询参数作为Action方法的参数（推荐） #

直接在GetFile方法中声明参数，结合[FromQuery]特性明确指定从查询字符串绑定（[ApiController]特性已支持自动绑定，添加[FromQuery]是为了逻辑更清晰）：

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;

namespace ProjectName.Controllers
{
    [Route("/getfile")]
    [ApiController]
    [Authorize]
    public class ReturnFileController : ControllerBase
    {
        [HttpGet()]
        public async Task<IActionResult> GetFile([FromQuery] int? fileId)
        {
            // 异步方法必须添加await关键字
            var file = await GetFileAsync(fileId);
            // 补充文件返回逻辑，示例：
            // return File(file.Content, file.ContentType, file.FileName);
            return Ok();
        }

        // 示例异步获取文件方法
        private async Task<File> GetFileAsync(int? fileId)
        {
            // 实现文件获取逻辑
            return new File();
        }
    }
}

方案2：通过控制器类属性绑定查询参数 #

若需将参数作为控制器类的属性，使用ASP.NET Core的[FromQuery]特性标记属性，[ApiController]会自动完成绑定：

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;

namespace ProjectName.Controllers
{
    [Route("/getfile")]
    [ApiController]
    [Authorize]
    public class ReturnFileController : ControllerBase
    {
        [FromQuery]
        public int? fileId { get; set; }

        [HttpGet()]
        public async Task<IActionResult> GetFile()
        {
            var file = await GetFileAsync(fileId);
            // 补充文件返回逻辑
            return Ok();
        }

        private async Task<File> GetFileAsync(int? fileId)
        {
            // 实现文件获取逻辑
            return new File();
        }
    }
}

额外注意点 #

• 调用异步方法GetFileAsync时必须添加await，否则会导致异步操作未完成就继续执行，引发逻辑错误。
• 移除不必要的Blazor命名空间using Microsoft.AspNetCore.Components;，避免特性使用场景混淆。

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