# Vane.Container **Repository Path**: netcasewqs/Vane.Container ## Basic Information - **Project Name**: Vane.Container - **Description**: .NET 依赖注入容器:生命周期、keyed 服务、集合解析、作用域、AOP、装饰器与 MEF 形态组件导出 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Vane.Container .NET 依赖注入容器。核心程序集只依赖 BCL,提供生命周期、keyed 服务、集合解析、作用域、AOP、装饰器与 MEF 形态的组件导出;另有编译期源生成器,以及 Prism 与 ASP.NET Core 适配工程。 版本 `1.0.0`。目标框架 `net8.0` 与 `net10.0`。 README 只给可执行的入口,概念与设计取舍见 [`Vane-DI-容器入门书.md`](Vane-DI-容器入门书.md)。 ## 安装 ```bash dotnet add package Vane.Container # 核心容器 dotnet add package Vane.Container.Prism # Prism 8 适配(net8.0) dotnet add package Vane.Container.AspNetCore # HostBuilder 接线(net10.0) ``` SourceGen 随主包以 `analyzers/dotnet/cs` 资产分发,装包即生效,无需手工引用生成器。适配包只在目标框架匹配时才可用:`Vane.Container.Prism` 为 net8.0 资产,net10.0 应用同样可加载;`Vane.Container.AspNetCore` 为 net10.0,依赖 `Microsoft.Extensions.*` 10.0.0。适配包把主包作为普通依赖引入,analyzer 资产不随传递依赖生效,需要源生成器时请显式安装 `Vane.Container`。 源码仓库直接引用: ```bash dotnet add reference src/Vane.Container/Vane.Container.csproj ``` ## 快速开始 ```csharp using Vane.Container; var services = new ContainerBuilder(); services.AddSingleton(); services.AddTransient(); var container = services.BuildMiniContainer(); var greeter = container.GetRequiredService(); using var scope = container.CreateScope(); var session = scope.ServiceLocator.GetRequiredService(); ``` 构造函数注入默认生效,无需特性。`BuildMiniContainer()` 返回 `MiniContainer`(完整能力),`BuildServiceProvider()` 返回 `IServiceLocator`(MS-DI 兼容视图),`new MiniContainer(registry)` 创建可动态注册的容器。 ## 主要能力 - 生命周期 `Singleton` / `Transient` / `Scoped` - 注入:`[Inject]`(构造器、属性、字段、方法)、`[InjectMany]`(集合) - 集合:`T[]` / `IEnumerable` / `IList` / `ImmutableArray`,以及 `Lazy` 与元数据视图 - Keyed 服务、开放泛型、AOP、装饰器、实例生命周期观察者 - 组件及组件成员(字段、属性、方法)导出与动态组合 ## 适配工程 ### Prism ```csharp using Prism.Ioc; using Vane.Container.Prism; public partial class App : PrismApplication { protected override IContainerExtension CreateContainerExtension() => VaneContainerExtension.CreateContainer(); protected override Window CreateShell() => Container.Resolve(); protected override void RegisterTypes(IContainerRegistry containerRegistry) { containerRegistry.RegisterSingleton(); containerRegistry.Register("main"); // 命名注册映射为 keyed 服务 } } ``` `Instance` 属性暴露底层 `ContainerBuilder`,可与原生 API 混用。脱离 Prism 单独使用(样例、单测)必须自行调用一次 `FinalizeExtension()`,否则 `Resolve` 失败。 ```csharp IContainerExtension extension = VaneContainerExtension.CreateContainer(); extension.RegisterSingleton(); extension.FinalizeExtension(); // 缺这一步 Resolve 会失败 var message = extension.Resolve(); ``` ### ASP.NET Core ```csharp using Vane.Container.AspNetCore; var builder = WebApplication.CreateBuilder(args); builder.Host.UseVaneContainer(); builder.Services.AddSingleton(); builder.Services.AddScoped(); var app = builder.Build(); app.MapGet("/", (IClock clock, IRequestId id) => $"{clock.Now} / {id.Value}"); app.Run(); ``` 传统主机同样用 `.UseVaneContainer()`,自定义主机可直接传 `new VaneServiceProviderFactory()`。不要自行注册 `IServiceProvider`:它会遮蔽核心的作用域处理,让请求作用域拿到根实例。 两份适配的完整说明见入门书[第十七章](Vane-DI-容器入门书.md)与[第十八章](Vane-DI-容器入门书.md)。 ## 构建与验证 ```bash dotnet build Vane.Container.sln -c Release dotnet test tests/Vane.Container.Tests/Vane.Container.Tests.csproj -c Release dotnet test tests/Vane.Container.PortedTests/Vane.Container.PortedTests.csproj -c Release # 样例 dotnet run --project samples/Vane.Container.Samples -c Release ``` ```text tests/Vane.Container.Tests # 510 个 NUnit 用例 tests/Vane.Container.PortedTests # 97 个 NUnit 端口一致性用例 tests/Vane.Container.Prism.Tests # 控制台断言程序,不计入用例数 ``` 性能与驻留对比见 `benchmarks/RESULTS.md`。 ## 文档 - [`Vane-DI-容器入门书.md`](Vane-DI-容器入门书.md):从概念到内部实现的完整教材,按章顺序读 - [`docs/api-reference.md`](docs/api-reference.md):公开 API - [`CHANGELOG.md`](CHANGELOG.md):版本变更 - [MIT](LICENSE)