SetClientContext

Stores a ClientContext on the current request, so every later GetClientContext returns it instead of reading the connection.

Use it from middleware that captures the values once per request, or from a test that needs fixed values with no real connection behind them. The HttpContext.Items key is private to the package, so this is the only supported way to seed the entry.

Usage

using Microsoft.AspNetCore.Http;
using AlmightyShogun.AspNet.Core;

public sealed class ClientContextMiddleware(RequestDelegate next)
{
    public async Task InvokeAsync(HttpContext context)
    {
        context.SetClientContext(new ClientContext
        {
            IpAddress = context.GetIpAddress(),
            UserAgent = context.Request.Headers.UserAgent.ToString()
        });

        await next(context);
    }
}

Parameters

clientContext: ClientContext
The context to pin for the rest of the request, replacing anything stored before it.

Type signature

public void SetClientContext(ClientContext clientContext);