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

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

  • Статья

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

<Элемент 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" />

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

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

Атрибуты

Атрибут Тип атрибута Описание
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. Дополнительные сведения см. в разделе Параметры политики директив среды выполнения.

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

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

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

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

Комментарии

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

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

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

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

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