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

Статья
07/05/2024

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

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

Синтаксис

<Library Name="assembly_name" />

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

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

Атрибуты

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

Name - атрибут

значение	Описание
assembly_name	Простое имя сборки без расширения файла. Этот атрибут соответствует свойству AssemblyName.Name. Например, имя сборки с именем Extensions.dll является «Extensions». Сведения об особой форме имени сборки assembly_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>

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