.NET Web API如何从请求头（Header）中获取数据-C#.Net教程-PHP中文网

.NET Web API如何从请求头（Header）中获取数据

月夜之吻

发布： 2025-11-17 17:31:02

原创

704人浏览过

答案：.NET Web API 可通过 HttpContext.Request.Headers 读取请求头，支持 TryGetValue 安全获取 Authorization、X-Device-Id 等值；也可用索引访问 User-Agent；中间件中可预处理如 X-Api-Key 验证；频繁字段可用 ActionFilter 如 TenantFilter 自动提取 X-Tenant-Id。

.net web api如何从请求头（header）中获取数据

.NET Web API 可以通过多种方式从 HTTP 请求头中读取数据，适用于获取自定义参数、身份令牌、设备信息等场景。以下是常用且实用的方法。

1. 使用 HttpContext.Request.Headers

在控制器中，可以通过 HttpContext.Request.Headers 直接访问所有请求头字段。它返回一个键值集合，支持按名称获取对应值。

示例代码：

[HttpGet("info")]
public IActionResult GetInfo()
{
    if (HttpContext.Request.Headers.TryGetValue("Authorization", out var authValue))
    {
        // 获取 Authorization 头
        var token = authValue.ToString();
        // 处理 token
    }

    if (HttpContext.Request.Headers.ContainsKey("X-Device-Id"))
    {
        var deviceId = HttpContext.Request.Headers["X-Device-Id"];
        // 使用设备 ID
    }

    return Ok(new { Success = true });
}

登录后复制

注意：Header 名称不区分大小写，但建议使用标准命名方式。TryGetValue 更安全，避免因键不存在而抛出异常。

2. 通过 IHeaderDictionary 的便捷访问

Request.Headers 实现了 IHeaderDictionary 接口，可以直接用字符串索引访问。

示例：

var userAgent = HttpContext.Request.Headers["User-Agent"].ToString();
var customParam = HttpContext.Request.Headers["X-Custom-Header"].ToString();

登录后复制

如果头不存在，返回的是空的 StringValues，调用 ToString() 会得到空字符串，不会报错。

3. 在中间件中读取请求头

若需在请求进入控制器前处理头信息（如认证、日志），可在自定义中间件中读取。

示例中间件：

笔头写作

AI为论文写作赋能，协助你从0到1。

查看详情

public async Task InvokeAsync(HttpContext context, RequestDelegate next)
{
    if (context.Request.Headers.TryGetValue("X-Api-Key", out var apiKey))
    {
        if (!IsValidApiKey(apiKey))
        {
            context.Response.StatusCode = 401;
            await context.Response.WriteAsync("Invalid API Key");
            return;
        }
    }

    await next(context);
}

登录后复制

注册中间件到 Program.cs 中即可生效。

4. 模型绑定或 Action 过滤器自动提取

对于频繁使用的头字段（如租户 ID、语言设置），可封装成过滤器自动注入。

示例：ActionFilter 提取 X-Tenant-Id

public class TenantFilter : ActionFilterAttribute
{
    public override void OnActionExecuting(ActionExecutingContext context)
    {
        if (context.HttpContext.Request.Headers.TryGetValue("X-Tenant-Id", out var tenantId))
        {
            // 存入 ViewBag 或依赖注入服务
            context.ActionArguments["tenantId"] = tenantId.ToString();
        }
        base.OnActionExecuting(context);
    }
}

登录后复制

然后在控制器方法上应用该过滤器。

基本上就这些。根据实际需求选择合适的方式，多数情况下直接使用 HttpContext.Request.Headers 就足够了，简单明了。注意别忘了做空值判断和安全性校验。

以上就是.NET Web API如何从请求头（Header）中获取数据的详细内容，更多请关注php中文网其它相关文章！