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


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

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

<Элемент "Библиотека> элементов <Директив">

Синтаксис

<Library Name="assembly_name" />

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

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

Атрибуты

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

Name - атрибут

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

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

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

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

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

Замечания

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

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

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

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

См. также