VaraniumSharp 5.3.0

VaraniumSharp

VaraniumSharp 是一个非常简单的助手库，旨在拥有可重用、可靠的组件。它被编写为不依赖于任何其他库，因此可以轻松地将其放入任何项目中以获取其所提供的功能。

功能

• 提供辅助属性以实现基于属性的依赖注入。注入由额外的软件包处理，从而实现提供方中立
• 提供不同类型的缓存，包括引用计数缓存
• 为 PackageManager 提供一个接口
• 提供一个根据某些值对内容进行优先级排序的集合
• 提供并发助手，包括可处置的 SemaphoreSlim 以便于简单使用
• 提供创建可重新配置设置类的基类，允许在取消时轻松回滚设置值
• 提供一些封装基本功能的扩展方法
• 提供对静态 Microsoft 类型的各种封装，以便在依赖注入系统中使用
• 基于 Microsoft.Extensions.Logging 提供静态日志记录器。日志记录器主要存在于抽象用户的日志框架与 VaraniumSharp 库之间，以便它们可以记录到用户首选的日志记录器。

要求

要利用 VaraniumSharp 提供的依赖注入属性，需要一个包装 DI 框架的包。目前，VaraniumSharp 框架支持两个这样的包，一个用于 DryIoC，另一个用于 Microsoft ServiceCollection。也很容易通过简单地实现 VaraniumSharp.DependencyInjection.AutomaticContainerRegistration 类来为您首选的提供程序创建自定义包装，这个类可以直接在项目中实现，或者作为一个额外的库来实现。要了解如何实现此接口，请参考现有的任何一个包。

基本设置

VaraniumSharp 大部分的功能可以直接利用，但是要使项目中的 DI 属性生效，需要几个步骤。

向您想要添加到 DI 容器的类中添加一个属性。有两种主要属性，具有各种属性，更多详情请参阅 文档

// The attribute tells the DI system to create a registration fo the TabWindowContext for the interface ITabWindowContext
[AutomaticContainerRegistration(typeof(ITabWindowContext))]
public sealed class TabWindowContext : ITabWindowContext

接下来，在应用程序启动期间，将包含可注入类的 DLL 装载到 AppDomain 中，然后创建容器，并请求设置它。之后，您可以从容器中解析应用程序的主要部分并执行它。

// It is required to pre-load the assemblies that are auto-injected by VaraniumSharp otherwise their injections won't be picked up
AppDomain.CurrentDomain.Load(new AssemblyName("VaraniumSharp.WinUI"));

// Set up your IoC container and request that all classes are registered
var containerSetup = new ContainerSetup();
containerSetup.RetrieveClassesRequiringRegistration(true);
containerSetup.RetrieveConcretionClassesRequiringRegistration(true);

框架库

依赖注入

• VaraniumSharp.DryIoC 库，用于封装 DryIoc.dll IoC 容器，以便使用基于属性的 DI。
• VaraniumSharp.ServiceCollection 库，用于封装 Microsoft.Extensions.DependencyInjection.Abstraction。这对于容易实现 ASP.net 项目的 DI 非常有用。

前端

• VaraniumSharp.WinUI 库，它包含用于 WinUI 3 的辅助程序和组件。

包装器

• VaraniumSharp.CompoundDocumentFormatStorage 库，用于封装 OpenMcdf。它实现了 IPackageManager 接口。
• VaraniumSharp.Discord 库，用于封装 Discord.Net，以便轻松设置 Discord 机器人。
• VaraniumSharp.Oidc 库，用于封装 IdentityModel.OidcClient，以便轻松实现 OIDC。

已弃用

• VaraniumSharp.Initiator 库，用于封装 DryIoc、OIDC、ApplicationInsights 和 Serilog。已被单独的包替代。
• VaraniumSharp.Monolith 库，提供在 VaraniumSharp.Initiator 之上的 WebService 功能。
• VarniumSharp.Shenfield 库，用于封装 WPF 辅助程序。

文档

有关库的详细概述，请参阅我们的 文档

注意

随着 VaraniumSharp 2.0.0 的发布，我们将转向 .NetStandard2.0，因为这支持所有 .Net 4.6.1+ 框架库，并允许利用 DotNet Core2.0+ 的功能。如果需要旧版本，请提交问题并请求支持，我们愿意适当进行多目标平台支持（注意，由于缺少库，无法支持 DotNet Core 1.x）

图标

Sprout 由 parkjisun 来自 Noun Project