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

Статья
07/05/2024

Служит в качестве контейнера для типов и членов типов приложения, метаданные которого доступны для отражения во время выполнения и применяет политику отражения среды выполнения ко всем программным элементам приложения.

<Элемент Application Element <> Directives> (rd.xml)

Синтаксис

<Application 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
`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	Необязательный атрибут Определяет политику для маршалинга структуры в машинный код.

Все атрибуты

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

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>	Применяет политику к сконструированному универсальному типу. Например, <элемент TypeInstantiation> можно использовать для определения политики для `List<String>` типа.
<Method>	Применяет политику к методу определенного типа.
<MethodInstantiation>	Применяет политику к сконструированному универсальному методу.
<Свойство>	Применяет политику к свойству определенного типа.
<Поле>	Применяет политику к полю определенного типа.
<Событие>	Применяет политику к событию определенного типа.

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

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

Замечания

Элемент <Directives> может содержать ноль или один <Application> элемент. Несколько элементов <Application> в одном файле директив отражения не поддерживаются.

Элемент <Application> можно использовать одним из двух способов:

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

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