Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices
2.2.1
Prefix Reserved
dotnet add package Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices --version 2.2.1
NuGet\Install-Package Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices -Version 2.2.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices" Version="2.2.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices" Version="2.2.1" />
<PackageReference Include="Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices --version 2.2.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices, 2.2.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices@2.2.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices&version=2.2.1
#tool nuget:?package=Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices&version=2.2.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices
Provides services for ASP.NET Framework applications to integrate with System Web Adapters, enabling session/authentication sharing with ASP.NET Core apps during incremental migration.
Getting Started
The package automatically adds an HTTP module to your web.config.
In Global.asax.cs:
using Microsoft.AspNetCore.SystemWebAdapters.Hosting;
public class MvcApplication : HttpApplication
{
protected void Application_Start()
{
HttpApplicationHost.RegisterHost(builder =>
{
builder.AddSystemWebAdapters();
});
// ... other startup code
}
}
Remote Session Server
Share session state with an ASP.NET Core application:
HttpApplicationHost.RegisterHost(builder =>
{
builder.AddSystemWebAdapters()
.AddRemoteAppServer(options => options.ApiKey = "your-api-key")
.AddSessionServer();
});
Shared Data Protection
Share encryption keys with ASP.NET Core:
using Microsoft.AspNetCore.DataProtection;
HttpApplicationHost.RegisterHost(builder =>
{
builder.AddDataProtection()
.PersistKeysToFileSystem(new DirectoryInfo(@"C:\shared-keys"))
.SetApplicationName("MySharedApp");
builder.AddSystemWebAdapters();
});
Additional Documentation
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET Framework | net472 is compatible. net48 was computed. net481 was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETFramework 4.7.2
- Microsoft.AspNetCore.DataProtection (>= 8.0.22)
- Microsoft.AspNetCore.DataProtection.SystemWeb (>= 2.3.0)
- Microsoft.AspNetCore.SystemWebAdapters (>= 2.2.1)
- Microsoft.AspNetCore.SystemWebAdapters.Abstractions (>= 2.2.1)
- Microsoft.Extensions.Hosting (>= 8.0.1)
- Microsoft.Extensions.Options.DataAnnotations (>= 8.0.0)
- System.Text.Json (>= 8.0.6)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices:
| Package | Downloads |
|---|---|
|
Aspire.Microsoft.AspNetCore.SystemWebAdapters
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.2.1 | 527 | 12/18/2025 |
| 2.2.0 | 1,048 | 12/10/2025 |
| 2.2.0-preview1.25568.2 | 386 | 11/19/2025 |
| 2.2.0-preview1.25554.5 | 153 | 11/5/2025 |
| 2.1.0 | 7,470 | 10/21/2025 |
| 2.0.0 | 76,357 | 2/5/2025 |
| 1.4.0 | 188,398 | 5/8/2024 |
| 1.3.2 | 138,909 | 1/26/2024 |
| 1.3.1 | 9,029 | 1/11/2024 |
| 1.3.0 | 30,181 | 11/15/2023 |
| 1.2.0 | 33,693 | 6/29/2023 |
| 1.2.0-preview.1.23219.1 | 297 | 4/26/2023 |
| 1.1.0 | 130,778 | 3/16/2023 |
| 1.0.0 | 42,474 | 11/22/2022 |
| 1.0.0-rc.1.22477.1 | 6,015 | 9/28/2022 |