Skip to main content
net10.0

Runtime server features for ASP.NET Core Blazor applications. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/763b4ef31ca4df6dae07c7ee8f39ea259b6980fa

Published
Mar 18, 2025
1y ago
Total Downloads
31.8M
31,849,446

Install

dotnet add package Microsoft.AspNetCore.Components.WebAssembly.Server --version 10.0.0-preview.2.25164.1
ProductVersions
.NET
net10.0

README

About

Microsoft.AspNetCore.Components.WebAssembly.Server provides runtime server features for ASP.NET Core Blazor applications that have a client running under WebAssembly.

Key Features

  • Provides the ability to statically render components that utilize WebAssembly interactivity
  • Enables debugging functionality for code running in WebAssembly
  • Allows serialization and transmission of server-side authentication state for use during WebAssembly interactivity

How to Use

To use Microsoft.AspNetCore.Components.WebAssembly.Server, follow these steps:

Installation

dotnet add package Microsoft.AspNetCore.Components.WebAssembly.Server

Configuration

To enable WebAssembly interactivity in a Blazor Web app, configure it in your app's Program.cs:

builder.Services.AddRazorComponents()
    .AddInteractiveWebAssemblyComponents();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseWebAssemblyDebugging();
}

app.UseAntiforgery();
app.MapStaticAssets();
app.MapRazorComponents<App>()
    .AddInteractiveWebAssemblyRenderMode()
    .AddAdditionalAssemblies(typeof(BlazorWebApp.Client._Imports).Assembly);

Make sure to update the call to AddAdditionalAssemblies with any client assemblies that should be included in the Blazor application.

Main Types

The main types provided by this package are:

  • WebAssemblyComponentsEndpointOptions: Provides options for configuring interactive WebAssembly components
  • AuthenticationStateSerializationOptions: Provides options for configuring the JSON serialization of the AuthenticationState to the WebAssembly client

Additional Documentation

For additional documentation and examples, refer to the official documentation on Blazor.

Feedback & Contributing

Microsoft.AspNetCore.Components.WebAssembly.Server is released as open-source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Changes from Previous Version

No structural changes between v10.0.0-preview.1.25120.3 and v10.0.0-preview.2.25164.1.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

This version is marked prerelease. Validate its API and upgrade path before production use.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.