DX.Data.Xpo.Identity.Mapster 26.1.3.40

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. .NET Framework 4.6.2 This package targets .NET Framework 4.6.2. The package is compatible with this framework or higher. 
dotnet add package DX.Data.Xpo.Identity.Mapster --version 26.1.3.40
                    


                    

                
NuGet\Install-Package DX.Data.Xpo.Identity.Mapster -Version 26.1.3.40
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="DX.Data.Xpo.Identity.Mapster" Version="26.1.3.40" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="DX.Data.Xpo.Identity.Mapster" Version="26.1.3.40" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="DX.Data.Xpo.Identity.Mapster" />
                    


                            Project file
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 DX.Data.Xpo.Identity.Mapster --version 26.1.3.40
                    


                    

                
#r "nuget: DX.Data.Xpo.Identity.Mapster, 26.1.3.40"
#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 DX.Data.Xpo.Identity.Mapster@26.1.3.40
#: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=DX.Data.Xpo.Identity.Mapster&version=26.1.3.40
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=DX.Data.Xpo.Identity.Mapster&version=26.1.3.40
                    


                            Install as a Cake Tool

DX.Data.Xpo.Identity.Mapster

Wires up DX.Data.Xpo.Identity's abstract stores with Mapster and a set of default XPO persistent entities — the AutoMapper-free alternative to DX.Data.Xpo.Identity.AutoMapper. This is the package to use if your Identity project must stay on net462.

Target frameworks: net462, net8.0, net9.0, net10.0 DevExpress dependency: transitive, via DX.Data.Xpo (26.1.*)

Behaviour changes in 26.1.3.40

  • AddXpoMapsterIdentityStores no longer writes the identity mapping rules into TypeAdapterConfig.GlobalSettings. The stores use a mapper of their own: a copy of your application's Mapster config with the identity rules added, built when the first store is created (later changes to GlobalSettings are not seen by the stores).
  • If your own code maps identity types through GlobalSettings and relied on those rules, call RegisterXPIdentityMapsterConfiguration() yourself, or use ApplyXPIdentityMapsterConfiguration(config) to add them to a config of your own.
  • LockoutEnd is mapped to LockoutEndDateUtc, so lockouts are persisted. See the DX.Data.Xpo.Identity release notes for the security fix this version includes.

Install

dotnet add package DX.Data.Xpo.Identity.Mapster

Install this or DX.Data.Xpo.Identity.AutoMapper — never both (see the root README).

Concrete stores (XPIdentityStores.cs)

Mirrors the AutoMapper package exactly, using Mapster's IMapper/ProjectToType<T>() instead:

public class XPMapsterUserStore<...>      : XPBaseUserStore<...>      { public XPMapsterUserStore(IDataLayer, MapsterMapper.IMapper, IValidator<TXPOUser>); }
public class XPMapsterRoleStore<...>      : XPBaseRoleStore<...>      { /* ... */ }
public class XPMapsterUserLoginStore<...> : XPBaseUserLoginStore<...> { /* ... */ }
public class XPMapsterUserClaimStore<...> : XPBaseUserClaimStore<...> { /* ... */ }
public class XPMapsterUserTokenStore<...> : XPBaseUserTokenStore<...> { /* ... */ }
public class XPMapsterRoleClaimStore<...> : XPBaseRoleClaimStore<...> { /* ... */ }

One-line registration (RegisterServices.cs)

public static IServiceCollection AddXpoMapsterIdentityStores<TUser>(this IdentityBuilder builder, string connectionName);
// + more-generic overloads for supplying your own persistent XPO entity types

Unlike the AutoMapper variant, this registers services.AddTransient<IMapper, Mapper>() and calls services.RegisterXPIdentityMapsterConfiguration<...>() instead of an AutoMapper Profile. XPIdentityMapsterConfig.RegisterXPIdentityMapsterConfiguration<...> (also shipped in this package) configures TypeAdapterConfig<TUser, TXPOUser>.NewConfig().Ignore(...) for the collection-navigation properties, plus .AfterMapping() callbacks that restore FK id fields (like RoleId/UserId) that Mapster's .Ignore() would otherwise blank out on the mapped target — a subtlety AutoMapper's profile doesn't need to worry about because of how it handles ignored members differently.

Usage

services
    .AddIdentity<ApplicationUser>(options => { /* lockout, password policy, etc. */ })
    .AddXpoMapsterIdentityStores<ApplicationUser>("DefaultConnection")
    .AddDefaultTokenProviders();

See the root README for the full config sample including JWT/token service setup used alongside DX.Blazor.Identity.

Notes

  • If you're on net462 and were using DX.Data.Xpo.Identity.AutoMapper before 26.1.3.34, this package is your migration path — the registration call and store shapes are deliberately identical (AddXpoMapsterIdentityStores vs AddXpoAutoMapperIdentityStores), only the underlying mapper changes.
  • For Blazor Server/WASM login UI on top of this, see DX.Blazor.Identity.

See the root README for the full package list and DevExpress version alignment notes.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Framework net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
26.1.3.40 87 11/4/2026
26.1.3.39 110 10/26/2026
26.1.3.38 128 10/14/2026
26.1.3.37 155 8/6/2026
26.1.3.36 143 7/31/2026
26.1.3.35 141 7/14/2026
25.2.3.34 164 4/7/2026
24.2.3.34 269 1/27/2025

26.1.3.40: Built against DX.Data.Xpo.Identity 26.1.3.40 (security fix: redeemed recovery codes stayed valid; lockout is persisted; see its release notes). LockoutEnd is mapped to LockoutEndDateUtc. The stores use a mapper of their own: AddXpoMapsterIdentityStores no longer writes the identity rules into TypeAdapterConfig.GlobalSettings (which also made parallel registrations throw). Behaviour change: code that maps identity types through GlobalSettings itself must call RegisterXPIdentityMapsterConfiguration(); ApplyXPIdentityMapsterConfiguration(config) adds the rules to a config of your own.
26.1.3.39: Rebuilt against DX.Data.Xpo.Identity 26.1.3.39 (the Microsoft.Extensions.Identity packages per target framework (8.0 for net8.0, 9.0 for net9.0, 10.0 for net10.0): 10.0 on net8.0 brought Microsoft.AspNetCore.Cryptography.Internal 10 into .NET 8 apps and broke Data Protection (tokens, antiforgery) on Linux.)
26.1.3.37: Rebuilt against DX.Data.Xpo.Identity 26.1.3.37 / DX.Data.Xpo.Mapster 26.1.3.34 to pick up the System.Security.Cryptography.Xml 8.0.4 fix (NU1903) transitively.
26.1.3.36: Added a README.md with technical documentation, now embedded in the package via PackageReadmeFile.
26.1.3.35: Rebuilt against DX.Data.Xpo.Identity 26.1.3.35 / DX.Data.Xpo.Mapster 26.1.3.32 to pick up DevExpress v26.1.3 transitively.