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

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

  • Статья

Применяет политику отражения среды выполнения ко всем типам в указанной сборке.

Синтаксис

<Assembly Name="assembly_name"
          Activate="policy_setting"
          Browse="policy_setting"
          Dynamic="policy_setting"
          Serialize="policy_setting"
          DataContractSerializer="policy_setting"
          DataContractJsonSerializer="policy_setting"
          XmlSerializer="policy_setting"
          MarshalObject="policy_setting"
          MarshalDelegate="policy_setting"
          MarshalStructure="policy_setting" />

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

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

Атрибуты

Атрибут Тип атрибута Описание
Name Общие сведения Обязательный атрибут. Задает простое имя сборки.
Activate Отражение Необязательный атрибут. Управляет доступом среды выполнения к конструкторам для включения активации экземпляров.
Browse Отражение Необязательный атрибут. Определяет запрос для получения сведений о типах или перечисляет типы в сборке, но не включает динамический доступ во время выполнения.
Dynamic Отражение Необязательный атрибут. Управляет доступом среды выполнения ко всем членам типа, включая конструкторы, методы, поля, свойства и события, чтобы включить динамическое программирование.
Serialize Сериализация Необязательный атрибут. Управляет доступом среды выполнения к конструкторам, полям и свойствам, позволяющим сериализовать и десериализовать экземпляры типа с помощью таких библиотек, как, например, сериализатор Newtonsoft JSON.
DataContractSerializer Сериализация Необязательный атрибут. Определяет политику для сериализации, в которой используется класс System.Runtime.Serialization.DataContractSerializer.
DataContractJsonSerializer Сериализация Необязательный атрибут. Определяет политику для сериализации JSON, в которой используется класс System.Runtime.Serialization.Json.DataContractJsonSerializer.
XmlSerializer Сериализация Необязательный атрибут. Определяет политику для сериализации XML, в которой используется класс System.Xml.Serialization.XmlSerializer.
MarshalObject Interop Необязательный атрибут. Определяет политику для маршалинга ссылочных типов в среды выполнения Windows и COM.
MarshalDelegate Interop Необязательный атрибут. Определяет политики для маршалинга типов делегатов как указателей функции на машинный код.
MarshalStructure Interop Необязательный атрибут. Определяет политику для маршалинга структуры в машинный код.

Name - атрибут

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

Можно также указать строковый литерал *Application* для применения политики ко всем сборкам в пакете приложения, вне зависимости от того, загружены ли эти сборки или нет. *Application* никогда не применяет политику к сборкам платформы .NET Framework.

Все остальные атрибуты

Значение Описание
policy_setting Параметр для этого типа политики для всех типов в сборке. Допустимые значения All, Auto, Excluded, Public, PublicAndInternal, Required Public, Required PublicAndInternal и Required All. Дополнительные сведения см. в разделе Параметры политики директив среды выполнения.

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

Элемент Описание
<Пространство имен> Применяет политику отражения для всех типов в дочернем пространстве имен.
<Тип> Применяет политику отражения к типу.
<TypeInstantiation> Применяет политику отражения к сконструированному универсальному типу.

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

Элемент Описание
<Приложение> Служит в качестве контейнера для типов и членов типов приложения, метаданные которого доступны для отражения во время выполнения. Элемент <Application> может содержать ноль, один или несколько <Assembly> элементов.
<Библиотека> Определяет сборку, содержащую типы и члены типов, метаданные которой доступны для отражения во время выполнения. Элемент <Library> может иметь ноль или один <Assembly> элемент.

Комментарии

Элемент <Assembly> определяет политику среды выполнения для всех типов в сборке. Он отличается от <элемента Library> , который указывает библиотеку, но зависит от ее дочерних элементов для определения политики отражения среды выполнения. Элемент <Assembly> применяется ко всем типам в сборке, если они не переопределены дочерним элементом.

В следующем примере показано, как применить политику среды выполнения ко всем типам сборок в пакете Name приложения, назначив атрибуту значение "*Application*". Элемент <Assembly> должен быть дочерним по отношению к элементу <Application> .

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
     <Assembly Name="*Application*" Dynamic="Required All" />
  </Application>
</Directives>

Атрибуты Activate, Browse, Dynamic и Serialize необязательны. Тем не менее, элемент <Assembly> должен содержать хотя бы один из этих атрибутов.

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