Microsoft.AspNetCore.SystemWebAdapters.CoreServices 2.2.0

Microsoft.AspNetCore.SystemWebAdapters.CoreServices

Provides services and middleware for using System Web Adapters in ASP.NET Core applications. Includes session management, remote app integration, HTTP handlers/modules, and more.

Getting Started

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddSystemWebAdapters();

var app = builder.Build();
app.UseRouting();
app.UseSystemWebAdapters();
app.Run();

Usage

Session State

Local session (backed by ASP.NET Core):

builder.Services.AddSystemWebAdapters()
    .AddWrappedAspNetCoreSession();

builder.Services.AddDistributedMemoryCache();
builder.Services.AddSession();

Remote session (shared with ASP.NET Framework):

builder.Services.AddSystemWebAdapters()
    .AddRemoteAppClient(options =>
    {
        options.RemoteAppUrl = new Uri("https://framework-app.example.com");
        options.ApiKey = "your-api-key";
    })
    .AddSessionClient();

HTTP Handlers

app.MapHttpHandler<MyCustomHandler>("/handler.ashx");

public class MyCustomHandler : IHttpHandler
{
    public bool IsReusable => true;
    
    public void ProcessRequest(System.Web.HttpContext context)
    {
        context.Response.Write("Hello from IHttpHandler!");
    }
}

HTTP Modules

builder.Services.AddSystemWebAdapters()
    .AddHttpModules(modules => modules.Add<MyCustomModule>());

Additional Documentation

No packages depend on Microsoft.AspNetCore.SystemWebAdapters.CoreServices.

Version Downloads Last updated
2.2.1 0 12/18/2025
2.2.0 1 12/17/2025
2.2.0-preview1.25568.2 8 11/24/2025
2.2.0-preview1.25554.5 0 11/5/2025
2.1.0 2 10/23/2025
2.0.0 5 3/5/2025
1.4.0 4 3/5/2025
1.3.2 5 3/5/2025
1.3.1 6 3/5/2025
1.3.0 7 2/14/2024
1.2.0 5 3/5/2025
1.2.0-preview.1.23219.1 4 3/8/2025
1.1.0 6 3/5/2025
1.0.0 6 3/5/2025
1.0.0-rc.1.22477.1 3 3/3/2025