记得前面老周写过在.net core 中使用 Composition 的烂文。上回老周给大伙伴们介绍的是一个“重量级”版本—— System.ComponentModel.Composition。应该说，这个“重量级”版本是.NET 框架中的“标配”。
很多东西都会有双面性，MEF 也一样，对于扩展组件灵活方便，同时也带来性能上的一些损伤。但这个损伤应只限于应用程序初始化阶段，一般来说，我们也不需要频繁地去组合扩展，程序初始化时执行一次就够了。所以，性能的影响应在开始运行的时候。
与“重量级”版本在同一天发布的，还有一个“轻量级”版本—— System.Composition。相对于“标配”，这个库简洁了许多，与标准 MEF 相比，使用方法差不多，只是有细微的不同，这个老周稍后会讲述的，各位莫急。还有一个叫 Microsoft.Composition 的库，这个是旧版本的，适用于 Windows 8/8.1 的应用。对于 Core，可以不考虑这个版本。
System.Composition 相对于标准的 MEF，是少了一些功能的，尤其是对组件的搜索途径，MEF 的常规搜索途径有：应用程序范围、程序集范围、目录（文件夹）范围等。而“轻量级”版本只在程序集范围中搜索。这也很适合.net core 程序，尤其是 Web 项目。
好了，以上内容皆是纸上谈 B，下面咱们说干货。
1、安装需要的 NuGet 包
虽然在官方 docs 上，.net core API 目录收录了 System.Composition ，但默认安装的 .net core 库中是不包含 System.Composition 的，需要通过 Nuget 来安装。在 Nuget 上搜索 System.Composition，你会看到有好几个库。
那到底要安装哪个呢？很简单，选名字最短那个，其他几个因为存在依赖关系，会自动安装的。
这里老周介绍用命令来安装，很方便。在 VS 主窗体中，打开菜单【工具】-【NuGet 包管理器】-【程序包管理器控制台】，这样你就打开了一个命令窗口，然后输入：
Install-Package System.Composition
需要说的，输入的内容是不区分大小写的，你可以全部输入小写。这风格是很 PowerShell 的，这个很好记，PS 风格的命令都是“动词 + 名词”，中间一“减号”，比如，Get-Help。所以，安装的单词是 Install，程序包是 Package，安装包就是 Install-Package，然后你可以猜一下，那么卸载 Nuget 包呢，Uninstall-Package，那更新呢，Update-Package，查找包呢，Find-Package……
你要是不信，可以执行一下 get-help Nuget 看看。
好了，执行完对 System.Composition 的安装，它会自动把依赖的库也安装。
不带其他参数的 install-package ，默认会安装最新版本的库，所以说，执行这个来安装很方便。
2、导出类型
类型的导出方法与标准的 MEF 一样的，比如这样。
???[Export] ???public class FlyDisk ???{ ???}于是，这个 FlyDisk 类就被导出了。你也可以为导出设置一个协定名，在合并组件后方便挑选。
???[Export("fly")] ???public class FlyDisk ???{ ???}当然了，如果你的组件扩展模式是 接口 + 实现，通常为了兼容和规范，应该有个接口。这时候你标注 Export 特性时，要指明协定的 Type。
???[Export(typeof(IPerson))] ???public class BaiLei : IPerson ???{ ???????public string Name => "败类"; ???}如果你希望更严格地约束导入和导出协定，还可以同时指定 Name 和 Type。
???[Export("rz", typeof(IPerson))] ???public class RenZha : IPerson ???{ ???????public string Name => "人渣"; ???}3、构建容器
在组装扩展时，需要一个容器，用来导入或收集这些组件，以供代码调用。在“轻量级”版本中，容器的用法与标准的 MEF 区别较大，MEF 中用的是 CompositionContainer 类，但在 System.Composition 中，我们需要先创建一个 ContainerConfiguration，然后再创建容器。容器由 CompositionHost 类表示。
来，看个完整的例子。首先是导出类型。
???public interface IPerson ???{ ???????string Name { get; } ???????void Work(); ???} ???[Export(typeof(IPerson))] ???public class BaiLei : IPerson ???{ ???????public string Name => "败类"; ???????public void Work() ???????{ ???????????Console.WriteLine("影响市容。"); ???????} ???}然后，创建 ContainerConfiguration。
??ContainerConfiguration config = new ContainerConfiguration().WithAssembly(Assembly.GetExecutingAssembly());
ContainerConfiguration 类的方法，调用风格也很像 ASP.NET Core，WithXXX 方法会把自身实例返回，以方便连续调用。上面代码是设置查找扩展组件的程序集，这里我设定为当前程序集，如果是其他程序集，可以用 Load 或 LoadFrom 方法先加载程序集，然后再调用 WithAssembly 方法，原理差不多。
随后，便可以创建容器了。
???????????using(CompositionHost host = config.CreateContainer()) ???????????{ ???????????}调用 GetExport 方法可以直接获取到导出类型的实例。
???????????using(CompositionHost host = config.CreateContainer()) ???????????{ ???????????????IPerson p = host.GetExport<IPerson>(); ???????????????Console.Write($"{p.Name}，"); ???????????????p.Work(); ???????????}那，如果某个协定接口有多个实现类导出呢。咱们再看一例。
首先，定义公共的协定接口。
???public interface ICD ???{ ???????void Play(); ???}再定义两个导出类，都实现上面定义的接口。
???[Export(typeof(ICD))] ???public class DbCD : ICD ???{ ???????public void Play() ???????{ ???????????Console.WriteLine("正在播放盗版 CD ……"); ???????} ???} ???[Export(typeof(ICD))] ???public class BlCD : ICD ???{ ???????public void Play() ???????{ ???????????Console.WriteLine("正在播放蓝光 CD ……"); ???????} ???}然后，跟前一个例子一样，创建 ContainerConfiguration 实例，再创建容器。
???????????Assembly curAssembly = Assembly.GetExecutingAssembly(); ???????????ContainerConfiguration cfg = new ContainerConfiguration(); ???????????cfg.WithAssembly(curAssembly); ???????????using(CompositionHost host = cfg.CreateContainer()) ???????????{ ???????????????…… ???????????}接下来就是区别了，因为实现 ICD 接口并且标记为导出的类有两个，所以要调用 GetExports 方法。
???????????using(CompositionHost host = cfg.CreateContainer()) ???????????{ ???????????????IEnumerable<ICD> cds = host.GetExports<ICD>(); ???????????????foreach (ICD c in cds) ???????????????????c.Play(); ???????????}返回来的是一个 ICD （实际是 ICD 的实现类，但以 ICD 作为约束）列表，然后就可以逐个去调用了。结果如下图所示。
4、导入类型
导入的时候，除了调用 GetExport 方法外，还可以定义一个类，然后把类中的某个属性标记为由导入的类型填充。
看例子。先上接口。
???public interface IAnimal ???{ ???????void Eating(); ???}然后上实现类，并标为导出类型。
???[Export(typeof(IAnimal))] ???public class Dog : IAnimal ???{ ???????public void Eating() ???????{ ???????????Console.WriteLine("狗吃 Shi"); ???????} ???}定义一个类，它有一个 MyPet 属性，这个属性由 Composition 来导入类型实例，并赋给它。
???public class PeopleLovePets ???{ ?????? [Import] ???????public IAnimal MyPet { get; set; } ???}注意有一点很重要，MyPet 属性上一定要加上 Import 特性，因为 Composition 在组装类型时会检测是否存在 Import 特性，如果你不加的话，扩展组件就不会导入到 MyPet 属性上的。
接着，创建容器的方法与前面一样。
???????????ContainerConfiguration cfg = new ContainerConfiguration() ???????????????.WithAssembly(Assembly.GetExecutingAssembly()); ????????? ?PeopleLovePets pvl = new PeopleLovePets(); ???????????using(var host = cfg.CreateContainer()) ???????????{ ???????????????host.SatisfyImports(pvl); ???????????}但你会看到有差别的，这一次，要先创建 PeopleLovePets 实例，后面要调用 SatisfyImports 方法，在 PeopleLovePets 实例上组合导入的类型。
最后，你通过 MyPet 属性就能访问导入的对象了，以 IAnimal 为规范，实际类型是 Dog。
???????????IAnimal an = pvl.MyPet; ???????????an.Eating();
那，如果导出的类型是多个呢，这时就不能只用 Import 特性了，要用 ImportMany 特性，而且接收导入的 MyPet 属性要改为 IEnumerable<IAnimal>，表示多个实例。
???public class PeopleLovePets ???{ ???????[ImportMany] ???????public IEnumerable<IAnimal> MyPet { get; set; } ???}为了应对这种情形，我们再添加一个导出类型。
???[Export(typeof(IAnimal))] ???public class Cat : IAnimal ???{ ???????public void Eating() ???????{ ???????????Console.WriteLine("猫吃兔粮"); ???????} ???}创建容器和执行导入的处理过程都不变，但访问 MyPet属性的方法要改了，因为现在它引用的不是单个实例了。
???????????foreach (IAnimal an in pvl.MyPet) ???????????????an.Eating();
5、导出元数据
元数据不是类型的一部分，但可以作为类型的附加信息。有些时候是需要的，尤其是在实际使用时，Composition 组合它所找到的各种扩展组件，但在调用时，可能不会全部都调用，需要筛选出需要调用的那部分。
为导出类型添加元数据有两种方法。先说第一种，很简单，直接在导出类型上应用 ExportMetadata 特性，然后设置 Name 和 Value，每个 ExportMetadataAttribute 实例就是一条元数据，你会发现，它其实很像 key / value 结构。
看个例子，假设有这样一个公共接口。
???public interface IMail ???{ ???????void ReadBody(string from); ???}然后有两个导出类型。
???[Export(typeof(IMail))] ???public class MailLoader1 : IMail ???{ ???????public void ReadBody(string from) ???????{ ???????????Console.WriteLine($"Pop3：来自{from}的邮件"); ???????} ???} ???[Export(typeof(IMail))] ???public class MailLoader2 : IMail ???{ ???????public void ReadBody(string from) ???????{ ???????????Console.WriteLine($"IMAP：来自{from}的邮件"); ???????} ???}这两种类型所处理的逻辑是不同的，第一个是通过 POP3 收到的邮件，第二个是通过 IMAP 收到的邮件。为了在导入类型后能够进行判断和区分，可以为它们分别附加元数据。
???[Export(typeof(IMail))] ???[ExportMetadata("prot", "POP3")] ???public class MailLoader1 : IMail ???{ ??????…… ???} ???[Export(typeof(IMail))] ???[ExportMetadata("prot", "IMAP")] ???public class MailLoader2 : IMail ???{ ??????…… ???}在导入带元数据的类型时，可以用到这个类——Lazy<T, TMetadata>，它是 Lazy<T> 的子类，类如其名，就是延迟初始化的意思。
定义一个 MailReader 类，公开一个 Loaders 属性。
???public class MailReader ???{ ???????[ImportMany] ???????public IEnumerable<Lazy<IMail, IDictionary<string, object>>> Loaders { get; set; } ???}注意这里，Lazy 的 TMetadata，默认的实现，通过 IDictionary<string, object> 是可以存储导入的元数据的。上面咱们也看到，元数据在导出时，是以 Name / Value 的方式指定的，相当类似于字典的结构，所以，用字典数据类型自然就能存放导入的元数据。
执行导入的代码就很简单了，跟前面的例子差不多。
???????????ContainerConfiguration cfg = new ContainerConfiguration() ???????????????.WithAssembly(Assembly.GetExecutingAssembly()); ???????????MailReader mlreader = new MailReader(); ???????????using(CompositionHost host = cfg.CreateContainer()) ???????????{ ???????????????host.SatisfyImports(mlreader); ???????????}这时候，我们在访问导入的类型时，就可以根据元数据进行筛选了。
在这个例子中，咱们只调用带 IMAP 的邮件阅读器。
???????????IMail m = (from o in mlreader.Loaders ??????????????????????let t = o.Metadata["prot"] as string ??????????????????????where t == "IMAP" ??????????????????????select o).First().Value; ???????????m.ReadBody("da_sb@ppav.com");最后调用的结果如下
IMAP：来自da_sb@ppav.com的邮件
当然了，元数据还有更高级的玩法，你要是觉得附加 N 条 ExportMetadata 特性太麻烦，你还可以自己定义一个类来包装，注意在这个类上要标记 MetadataAttribute 特性，而且从 Attribute 类派生。为啥呢？因为元数据是不参与类型逻辑的，你要把它附加到类型上，只能作为 特性 来处理。
???[AttributeUsage(AttributeTargets.Class)] ???[MetadataAttribute] ???public class ExtMetadataInfoAttribute : Attribute ???{ ???????public string Remarks { get; set; } ???????public string Author { get; set; } ???????public string PublishTime { get; set; } ???}之后，就可以直接应用到导出类型上面了。
???public interface ITest ???{ ???????void RunTask(); ???} ???[Export(typeof(ITest))] ???[ExtMetadataInfo(Author = "单眼明", PublishTime = "2018-9-18", Remarks = "已 debug 了 71125 次")] ???public class DemoComp : ITest ???{ ???????public void RunTask() ???????{ ???????????Console.WriteLine("Demo 组件被调用"); ???????} ???} ???[Export(typeof(ITest))] ???[ExtMetadataInfo(Author = "大神威", PublishTime = "2018-10-5", Remarks = "预览版")] ???public class PlainComp : ITest ???{ ???????public void RunTask() ???????{ ???????????Console.WriteLine("Plain 组件被调用"); ???????} ???}导入时，同样可以 import 到一个属性中。
???public class MyAppPool ???{ ???????[ImportMany] ???????public IEnumerable<Lazy<ITest, IDictionary<string, object>>> Components { get; set; } ???}创建容器的方法一样。
???????????ContainerConfiguration cfg = new ContainerConfiguration() ???????????????.WithAssembly(Assembly.GetExecutingAssembly()); ???????????MyAppPool pool = new MyAppPool(); ???????????using(var host = cfg.CreateContainer()) ???????????{ ???????????????host.SatisfyImports(pool); ???????????}尝试枚举出导入类型的元数据。
???????????foreach (var ext in pool.Components) ???????????{ ???????????????var metadata = ext.Metadata; ???????????????Console.WriteLine($"{ext.Value.GetType()} 的元数据："); ???????????????foreach (var kv in metadata) ???????????????{ ???????????????????Console.WriteLine($"{kv.Key}: {kv.Value}"); ???????????????} ???????????????Console.WriteLine(); ???????????}执行结果如下图。
要是你觉得用 IDictionary<string, object> 类型来存放导入的元数据也很麻烦，那你也照样可以定义一个类来存放，但这个类要符合两点：a、带有无参数的公共构造函数，因为它是由 Composition 内部来实例化的；b、属性必须是公共并且有 get 和 set 访问器，即可写的，不然没法设置值了，而且属性名必须与导出时的元数据名称相同。
现在我们改一下刚刚的例子，定义一个类来存放导入的元数据。
???public class ImportedMetadata ???{ ???????public string Author { get; set; } ???????public string Remarks { get; set; } ???????public string PublishTime { get; set; } ???}然后，MyAppPool 类也可以改一下。
???public class MyAppPool ???{ ???????//[ImportMany] ???????//public IEnumerable<Lazy<ITest, IDictionary<string, object>>> Components { get; set; } ???????[ImportMany] ???????public IEnumerable<Lazy<ITest, ImportedMetadata>> Components { get; set; } ???}最后，枚举元数据的代码也改一下。
???????????foreach (var ext in pool.Components) ???????????{ ???????????????var metadata = ext.Metadata; ???????????????Console.WriteLine($"{ext.Value.GetType()} 的元数据："); ???????????????Console.WriteLine($"Author: {metadata.Author}\nRemarks: {metadata.Remarks}\nPublishTime: {metadata.PublishTime}"); ???????????????Console.WriteLine(); ???????????}====================================================================
好了，关于 System.Composition，今天老周就介绍这么多，内容也应该覆盖得差不多了。肚子饿了，准备开饭。
【.NET 深呼吸】.net core 中的轻量级 Composition
原文地址：https://www.cnblogs.com/tcjiaan/p/9612593.html