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

Статья
07/05/2024

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

Синтаксис

<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" />

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

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

Атрибуты

Атрибут	Тип атрибута	Description
`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.

значение	Описание
assembly_name	Простое имя сборки без расширения файла. Этот атрибут соответствует свойству AssemblyName.Name. Например, имя сборки с именем Extensions.dll является «Extensions». Можно также указать строковый литерал `Application` для применения политики ко всем сборкам в пакете приложения, вне зависимости от того, загружены ли эти сборки или нет. `Application` никогда не применяет политику к сборкам платформы .NET Framework.

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

значение Описание

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

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

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

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

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

Элемент	Description
<Приложение>	Служит в качестве контейнера для типов и членов типов приложения, метаданные которого доступны для отражения во время выполнения. Элемент <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> должен содержать хотя бы один из этих атрибутов.

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