<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 ネイティブ ツール チェーンにより自動的に含められないため、例では実行時に要求されたメンバー情報を表示できません。 必要なメタデータを提供するには、次の <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[]) メソッドを使用して文字列の 7 番目の文字の値を取得し、文字列のすべての文字を表示します。 例の変数 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 オブジェクトのメタデータは使用できないため、.NET ネイティブ ツール チェーンでコンパイルした場合、実行時に PropertyInfo.GetValue(Object, Object[]) メソッドを呼び出すと NullReferenceException 例外がスローされます。 例外を排除し、必要なメタデータを提供するには、次の <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) 構成ファイル リファレンス
• ランタイム ディレクティブ要素
• ランタイム ディレクティブ ポリシーの設定