Поделиться через

<Элемент Library> (.NET Native)

  • Статья

Определяет сборку, содержащую типы и члены типов, метаданные которой доступны для отражения во время выполнения.

<Элемент Library> элемента <Directives>

Синтаксис

<Library Name="assembly_name" />

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Описание
Name Обязательный атрибут. Задает имя сборки. Дочерние элементы данного элемента <Library> определяют политику отражения среды выполнения для типов и членов типов в этой сборке.

Name - атрибут

Значение Описание
assembly_name Простое имя сборки без расширения файла. Этот атрибут соответствует свойству AssemblyName.Name. Например, имя сборки с именем Extensions.dll является «Extensions». Сведения об особой форме имени сборки assembly_name с поддержкой условного включения метаданных сборки см. в разделе "Примечания".

Дочерние элементы

Элемент Описание
<Сборки> Применяет политику ко всем типам в определенной сборке.
<Пространства имен> Применяет политику ко всем типам в определенном пространстве имен.
<Тип> Применяет политику для конкретного типа, например, класса или структуры.
<TypeInstantiation> Применяет политику к сконструированному универсальному типу. Например, <элемент TypeInstantiation> можно использовать для определения политики для List<String> типа.

Родительские элементы

Элемент Описание
<Директивы> Корневой элемент файла директив среды выполнения.

Комментарии

Элемент <Directives> может содержать ноль, один или несколько <Library> элементов.

Элемент <Library> используется как контейнер для определения программных элементов, метаданные которых требуются во время выполнения. Этот элемент не выражают политики. Во время компиляции средства компилятора осуществляют поиск только в библиотеке, назначенной с помощью элемента <Library>, на наличие программных элементов, определенных его дочерними элементами. В отличие от этого, средства компилятора выполняют поиск программных элементов, определенных дочерними элементами <элемента Application> во всех библиотеках, including.NET Framework.

Директивы <Library> могут использоваться условно. Если имя <Library> элемента начинается и заканчивается звездочкой (*), директива <Library> действует только в том случае, если приложение ссылается на сборку, указанную между звездочками. Например, следующая директива среды выполнения применяется только в том случае, если приложение ссылается на Utilities.dll сборку.

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

См. также раздел