XiHan.Framework.MultiTenancy.Database 5.0.0-rc.2

Prefix Reserved

This is a prerelease version of XiHan.Framework.MultiTenancy.Database.

dotnet add package XiHan.Framework.MultiTenancy.Database --version 5.0.0-rc.2

NuGet\Install-Package XiHan.Framework.MultiTenancy.Database -Version 5.0.0-rc.2

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="XiHan.Framework.MultiTenancy.Database" Version="5.0.0-rc.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="XiHan.Framework.MultiTenancy.Database" Version="5.0.0-rc.2" />
                    

                            Directory.Packages.props

<PackageReference Include="XiHan.Framework.MultiTenancy.Database" />
                    

                            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 XiHan.Framework.MultiTenancy.Database --version 5.0.0-rc.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: XiHan.Framework.MultiTenancy.Database, 5.0.0-rc.2"

#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 XiHan.Framework.MultiTenancy.Database@5.0.0-rc.2

#: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=XiHan.Framework.MultiTenancy.Database&version=5.0.0-rc.2&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=XiHan.Framework.MultiTenancy.Database&version=5.0.0-rc.2&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

XiHan.Framework.MultiTenancy.Database

关于

XiHan.Framework.MultiTenancy.Database 是多租户的数据库提供程序：租户目录以实体经仓储读写，经 ICache 按租户缓存，分片从租户属性推出。装配后顶替默认的内存实现，需要同时装配一个持久化提供程序与一个提供 caching.local 的缓存提供程序（Standard 组合包已带内存缓存）。

主要特性

租户目录存在数据库里，TenantRecordStore 批量写入与删除，写后让所有共用缓存的实例立即失效
多实例部署装 Caching.Redis 与 Caching.Hybrid 即一致：命中在本机一级缓存，新增、停用、改连接串、删除立即传到每个实例
缓存后端故障时直接查库；写入时失效失败则调用失败、事务回滚
与分库配合：租户属性 ConnectionString 有值即分库

如何使用

安装

dotnet add package XiHan.Framework.MultiTenancy.Database --prerelease

使用

显式提供程序，和持久化提供程序一起装配（下面用 SqlSugar，按约定映射 TenantRecord）：

builder.AddXiHan(xihan => xihan
    .UseStandardProfile()
    .UseFeature(new SqlSugarPersistenceFeature(static (binding, config) =>
    {
        config.DbType = DbType.PostgreSQL;
        config.ConnectionString = binding.ValueOrThrow().Value;
    }))
    .UseFeature<DatabaseMultiTenancyFeature>());

{ "XiHan": { "MultiTenancy": { "Database": { "CacheTimeToLiveSeconds": 30 } } } }

存活时间必须为正（写入经失效立即生效，存活时间只是兜底）；缓存容量由缓存提供程序管。表结构由应用管理；PropertiesJson 列用长文本类型。

主要类型

此库提供的主要类型：

DatabaseMultiTenancyFeature：特性入口
DatabaseMultiTenancyOptions：目录缓存的存活时间
TenantRecord：租户存储行
DatabaseTenantStore：带缓存的 ITenantStore，InvalidateAsync / InvalidateAllAsync 失效所有实例的目录缓存
TenantRecordStore：实现租户管理 ITenantAdministration，作用域内的批量写入与删除；列举用 ITenantStore.ListAsync

反馈与贡献

XiHan.Framework.MultiTenancy.Database 以 MIT 许可证开源。欢迎到 GitHub 仓库提交问题和贡献。

Product	Compatible and additional computed target framework versions.
.NET	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.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Microsoft.Extensions.Caching.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.14)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Diagnostics.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Options (>= 10.0.14)
- System.Threading.RateLimiting (>= 10.0.14)
- XiHan.Framework.Caching.Abstractions (>= 5.0.0-rc.2)
- XiHan.Framework.MultiTenancy.Abstractions (>= 5.0.0-rc.2)
- XiHan.Framework.Persistence.Abstractions (>= 5.0.0-rc.2)

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
5.0.0-rc.2	0	11/15/2026
5.0.0-rc.1	106	11/13/2026
5.0.0-preview.3	57	11/11/2026
5.0.0-preview.2	96	11/6/2026
5.0.0-preview.1	52	11/4/2026

https://framework.docs.xihanfun.com/changelog