在ASP.NET Core5.0中访问HttpContext的方法步骤

(编辑：jimmy 日期: 2024/10/8 浏览：2)

ASP.NET Core 应用通过 IHttpContextAccessor 接口及其默认实现 HttpContextAccessor 访问 HttpContext。只有在需要访问服务内的 HttpContext 时，才有必要使用 IHttpContextAccessor。

通过 Razor Pages 使用 HttpContext

Razor Pages PageModel 公开 HttpContext 属性：

public class AboutModel : PageModel
{
  public string Message { get; set; }


  public void OnGet()
  {
    Message = HttpContext.Request.PathBase;
  }
}

通过 Razor 视图使用 HttpContext

Razor 视图通过视图上的 RazorPage.Context 属性直接公开 HttpContext。下面的示例使用 Windows 身份验证检索 Intranet 应用中的当前用户名：

@{
  var username = Context.User.Identity.Name;
  
  ...
}

通过控制器使用 HttpContext

控制器公开 ControllerBase.HttpContext 属性：

public class HomeController : Controller
{
  public IActionResult About()
  {
    var pathBase = HttpContext.Request.PathBase;


    ...


    return View();
  }
}

通过中间件使用 HttpContext

使用自定义中间件组件时，HttpContext 传递到 Invoke 或 InvokeAsync 方法，在中间件配置后可供访问：

public class MyCustomMiddleware
{
  public Task InvokeAsync(HttpContext context)
  {
    ...
  }
}

通过自定义组件使用 HttpContext

对于需要访问 HttpContext 的其他框架和自定义组件，建议使用内置的依赖项注入容器来注册依赖项。依赖项注入容器向任意类提供 IHttpContextAccessor，以供类在自己的构造函数中将它声明为依赖项：

public void ConfigureServices(IServiceCollection services)
{
   services.AddControllersWithViews();
   services.AddHttpContextAccessor();
   services.AddTransient<IUserRepository, UserRepository>();
}

如下示例中：

UserRepository 声明自己对 IHttpContextAccessor 的依赖。
当依赖项注入容器解析依赖链并创建 UserRepository 实例时，就会注入依赖项。

public class UserRepository : IUserRepository
{
  private readonly IHttpContextAccessor _httpContextAccessor;


  public UserRepository(IHttpContextAccessor httpContextAccessor)
  {
    _httpContextAccessor = httpContextAccessor;
  }


  public void LogCurrentUser()
  {
    var username = _httpContextAccessor.HttpContext.User.Identity.Name;
    service.LogAccessRequest(username);
  }
}

从后台线程访问 HttpContext

HttpContext 不是线程安全型。在处理请求之外读取或写入 HttpContext 的属性可能会导致 NullReferenceException。

要使用 HttpContext 数据安全地执行后台工作，请执行以下操作：

在请求处理过程中复制所需的数据。
将复制的数据传递给后台任务。

要避免不安全代码，请勿将 HttpContext 传递给执行后台工作的方法。而是传递所需要的数据。在以下示例中，调用 SendEmailCore，开始发送电子邮件。将 correlationId 传递到 SendEmailCore，而不是 HttpContext。代码执行不会等待 SendEmailCore 完成：

public class EmailController : Controller
{
  public IActionResult SendEmail(string email)
  {
    var correlationId = HttpContext.Request.Headers["x-correlation-id"].ToString();


    _ = SendEmailCore(correlationId);


    return View();
  }


  private async Task SendEmailCore(string correlationId)
  {
    ...
  }
}

上一篇：.NET必知的EventCounters性能指标监视器详解

下一篇：ASP.NET Core3.1 Ocelot负载均衡的实现