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

Статья
07/05/2024

Применяет политику среды выполнения для всех классов, унаследованных из содержащего типа.

Синтаксис

<Subtypes Activate="policy_type"
          Browse="policy_type"
          Dynamic="policy_type"
          Serialize="policy_type"
          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`. Дополнительные сведения см. в разделе Параметры политики директив среды выполнения.

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

Нет.

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

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

Замечания

Элемент <Subtypes> применяет политику ко всем подтипам его содержащего типа. Используется для применения различных политик для производных типов и их базовых классов.

Атрибуты отражения, сериализации и взаимодействия необязательны, несмотря на то, что по крайней мере один из них должен присутствовать.

Пример

В следующем примере определяется класс с именем BaseClass и подкласс с именем Derived1.

namespace Examples.Libraries
{
   public class BaseClass
   {
      public BaseClass()
      { }

      public override string ToString()
      {
          return String.Format("{0} Version  {1}", this.GetType().Name, Version);
      }
      public virtual double Version
      { get { return 1.0; }}
    }

   public class Derived1 : BaseClass
   {
      public Derived1() : base()
      {}

      public override double Version
      { get { return 1.1; }}

      public override string ToString()
      {
         return String.Format("{0} Version {1}", this.GetType().Name, Version);
      }
   }
}

Как показано в следующем коде, файл директив среды выполнения явно задает политики Dynamic и Activate для BaseClass в Excluded. Из-за этого, объекты типа BaseClass не могут использоваться для динамического создания экземпляров или создания путем вызовов конструктора класса BaseClass. Тем не менее, элемент <Subtypes> допускает использование классов, производных от BaseClass, для динамического создания экземпляров, а также для создания с помощью вызовов их конструкторов класса.

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
   <Assembly Name="*Application*" Dynamic="Required All" />
     <Type Name="Examples.Libraries.BaseClass" Activate ="Excluded" Dynamic="Excluded" >
        <Subtypes Activate="Public" Dynamic ="Public"/>
     </Type>
  </Application>
</Directives>

Благодаря директиве <Subtypes>, следующий код, динамически создающий экземпляр Derived1 экземпляр путем вызова метода Activator.CreateInstance(Type), выполняется успешно. Переменная блока здесь представляет собой TextBlock объект в пустом приложении UWP.

namespace Examples
{
   using System.Reflection;
   using Examples.Libraries;

   public sealed partial class MainPage : Page
    {
        public MainPage()
        {
            this.InitializeComponent();

            Derived1 d1 = new Derived1();
            block.Text += d1.ToString() + Environment.NewLine;

            Type derivedType = typeof(Derived1);
            Object obj = Activator.CreateInstance(derivedType);
            block.Text += obj.GetType().FullName + Environment.NewLine;
        }
    }
}

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