通过

<Library> 元素 (.NET Native)

  • 项目

定义包含元数据在运行时间可以用于反射的类型和类型成员的程序集。

<指令> 元素 <库> 元素

语法

<Library Name="assembly_name" />

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 描述
Name 必需的特性。 指定一个程序集的名称。 这个 <Library> 元素的子元素为在这个程序集中找到的类型和类型成员定义运行时反射策略。

Name 特性

Value 说明
assembly_name 程序集的简单名称，不要包含文件扩展名。 此特性对应 AssemblyName.Name 属性。 例如，一个名为 Extensions.dll 的程序集的名称为“Extensions”。 参阅“备注”部分，了解支持对来自程序集的元数据有条件包含的 assembly_name 的一种特殊形式。

子元素

元素 说明
<Assembly> 将策略应用到特定程序集中的所有类型。
<命名空间> 将策略应用到特定命名空间中的所有类型。
<类型> 将策略应用到一个特定类型，例如一个类或结构。
<TypeInstantiation> 将策略应用到一个构造泛型类型。 例如，一个 元素可以用来为一个 List<String> 类型定义策略。

父元素

元素 说明
<指令> 运行时指令文件的根元素。

注解

元素可包括零个、一个或多个 <Library> 元素。

<Library> 元素充当容器，用来定义其元数据在运行时间需要存在的程序元素；此元素不表示策略。 在编译时间，编译器工具仅搜索由 <Library> 元素指定的库，以查找其子元素识别出的程序元素。 相比而言，编译器工具搜索 .NET Framework 核心库等所有库，以查找由 元素的子元素识别出的程序元素。

<Library> 指令可以有条件地使用。 如果 <Library> 元素名称的前后都有一个星号 (*)，<Library> 指令仅在星号之间指定的程序集被该应用引用时才有效。 例如，以下运行时指令仅在该应用引用 Utilities.dll 程序集时适用。

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Library Name="*Utilities*">
   ...
  </Library>
</Directives>

另请参阅