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

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

Синтаксис

<Type Name="type_name"
      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" />

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

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

Атрибуты

Name - атрибут

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

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

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

Комментарии

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

<Type> Если элемент является дочерним элементом <элемента Assembly>, <Namespace><Type> или <TypeInstantiation>, он переопределяет параметры политики, определенные родительским элементом.

Элемент <Type> универсального типа применяет свою политику для всех экземпляров, которые не имеют собственной политики. Политика сконструированных универсальных типов определяется элементом <TypeInstantiation> .

Если тип является универсальным, его имя декорируется символом серьезного акцента ('), за которым следует число универсальных параметров. Например, атрибут Name элемента <Type> для класса System.Collections.Generic.List<T> отображается как Name="System.Collections.Generic.List`1".

Пример 1

В следующем примере отражение используется для отображения сведений о полях, свойствах и методах класса System.Collections.Generic.List<T>. Переменная b в примере является элементом TextBlock управления . Так как просто извлекаются сведения о типе, доступность метаданных определяется параметром политики Browse.

public static void GetReflectionInfo()
{
   Type t = typeof(List<>);
   b.Text += String.Format("Type information for {0}\n", t);

   // Get fields.
   b.Text += "\nFields:\n";

   var fields = t.GetTypeInfo().DeclaredFields;
   int nFields = 0;
   foreach (var field in fields)
   {
      b.Text += String.Format("   {0} ({1})", field.Name, field.FieldType.Name);
      nFields++;
   }
   if (nFields == 0) b.Text += "   None\n";

   // Get properties.
   b.Text += "\nProperties:\n";
   var props = t.GetTypeInfo().DeclaredProperties;
   int nProps = 0;
   foreach (var prop in props)
   {
      b.Text += String.Format("   {0} ({1})\n", prop.Name, prop.PropertyType.Name);
      nProps++;
   }
   if (nProps == 0) b.Text += "   None\n";

   // Get methods.
   b.Text += "\nMethods:\n";
   var methods = t.GetTypeInfo().DeclaredMethods;
   int nMethods = 0;
   foreach (var method in methods)
   {
      if (method.IsSpecialName) continue;
      b.Text += String.Format("   {0}({1}) ({2})\n", method.Name,
                              GetSignature(method), method.ReturnType.Name);
      nMethods++;
   }
   if (nMethods == 0) b.Text += "   None\n";
}

private static string GetSignature(MethodInfo m)
{
   string signature = null;
   var parameters = m.GetParameters();
   for (int ctr = 0; ctr < parameters.Length; ctr++)
   {
      signature += String.Format("{0} {1}", parameters[ctr].ParameterType.Name,
                                  parameters[ctr].Name);
      if (ctr < parameters.Length - 1) signature += ", ";
   }
   return signature;
}

Так как метаданные List<T> для класса не включаются автоматически в цепочку инструментов .NET Native, в примере не отображается запрошенная информация об элементе во время выполнения. Для обеспечения необходимыми метаданными, добавьте следующий элемент <Type> в файл директивы среды выполнения. Обратите внимание, что, так как мы предоставили родительский <элемент Namespace> , нам не нужно предоставлять полное имя типа в элементе <Type> .

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
   <Application>
      <Assembly Name="*Application*" Dynamic="Required All" />
      <Namespace Name ="System.Collections.Generic" >
        <Type Name="List`1" Browse="Required All" />
     </Namespace>
   </Application>
</Directives>

Пример 2

В следующем примере отражение используется для получения объекта PropertyInfo, представляющего свойство String.Chars[]. Затем он использует метод PropertyInfo.GetValue(Object, Object[]) для извлечения значения седьмого знака в строке и для отображения всех символов в строке. Переменная b в примере является элементом TextBlock управления .

public void Example()
{
  string test = "abcdefghijklmnopqrstuvwxyz";

  // Get a PropertyInfo object.
  TypeInfo ti = typeof(string).GetTypeInfo();
  PropertyInfo pinfo = ti.GetDeclaredProperty("Chars");

  // Show the seventh letter ('g')
  object[] indexArgs = { 6 };
  object value = pinfo.GetValue(test, indexArgs);
  b.Text += String.Format("Character at position {0}: {1}\n", indexArgs[0], value);

  // Show the complete string.
  b.Text += "\nThe complete string:\n";
  for (int x = 0; x < test.Length; x++)
  {
      b.Text += pinfo.GetValue(test, new Object[] {x}).ToString() + " ";
  }
}
// The example displays the following output:
//       Character at position 6: g
//
//       The complete string:
//       a b c d e f g h i j k l m n o p q r s t u v w x y z

Так как метаданные String для объекта недоступны, вызов PropertyInfo.GetValue(Object, Object[]) метода вызывает NullReferenceException исключение во время выполнения при компиляции с .NET Native цепочкой инструментов. Чтобы избежать исключений и предоставить необходимые метаданные, добавьте следующий элемент <Type> элемент в файл директив среды выполнения:

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

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

• Ссылка на файл конфигурации директив среды выполнения (rd.xml)
• Элементы директив среды выполнения
• Параметры политики директив среды выполнения