<Type> 要素 (.NET Native)

[アーティクル]
07/13/2023

クラスや構造体などの特定の型に実行時ポリシーを適用します。

構文

<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`	全般	必須の属性です。型名を指定します。
`Activate`	リフレクション	省略可能な属性です。コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。
`Browse`	リフレクション	省略可能な属性です。プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。
`Dynamic`	リフレクション	省略可能な属性です。コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。
`Serialize`	シリアル化	省略可能な属性です。コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。
`DataContractSerializer`	シリアル化	省略可能な属性です。 System.Runtime.Serialization.DataContractSerializer クラスを使用するシリアル化のポリシーを制御します。
`DataContractJsonSerializer`	シリアル化	省略可能な属性です。 System.Runtime.Serialization.Json.DataContractJsonSerializer クラスを使用する JSON シリアル化のポリシーを制御します。
`XmlSerializer`	シリアル化	省略可能な属性です。 System.Xml.Serialization.XmlSerializer クラスを使用する XML シリアル化のポリシーを制御します。
`MarshalObject`	Interop	省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。
`MarshalDelegate`	Interop	省略可能な属性です。ネイティブコードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。
`MarshalStructure`	Interop	省略可能な属性です。値型をネイティブコードにマーシャリングするためのポリシーを制御します。

Name 属性

[値]	説明
type_name	型名。この `<Type>` 要素が <Namespace> 要素または別の `<Type>` 要素の子である場合、type_name には名前空間なしで型の名前を含めることができます。それ以外の場合は、type_name には完全修飾型名を含める必要があります。

その他すべての属性

[値]	説明
policy_setting	このポリシーの種類に適用する設定です。指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。詳細については、「ランタイムディレクティブのポリシー設定」を参照してください。

子要素

要素	説明
<AttributeImplies>	含んでいる型が属性の場合は、その属性が適用されるコード要素の実行時ポリシーを定義します。
<イベント>	この型に属するイベントにリフレクションポリシーを適用します。
<フィールド>	この型に属するフィールドにリフレクションポリシーを適用します。
<GenericParameter>	ジェネリック型のパラメーターの型にポリシーを適用します。
<ImpliesType>	型にポリシーを適用します (それを含む `<Type>` 要素により表される型にそのポリシーが適用されている場合)。
<メソッド>	この型に属するメソッドにリフレクションポリシーを適用します。
<MethodInstantiation>	この型に属する構築されたジェネリックメソッドにリフレクションポリシーを適用します。
<プロパティ>	この型に属するプロパティにリフレクションポリシーを適用します。
<Subtypes>	それを含む型から継承されたすべてのクラスに実行時ポリシーを適用します。
`<Type>`	入れ子になった型にリフレクションポリシーを適用します。
<TypeInstantiation>	構築されたジェネリック型にリフレクションポリシーを適用します。

親要素

要素	説明
<Application>	実行時にリフレクションで使用可能なメタデータを持つ、アプリケーション全体の型と型のメンバーのコンテナーとして機能します。
<アセンブリ>	指定したアセンブリ内のすべての型にリフレクションポリシーを適用します。
<ライブラリ>	実行時にリフレクションに使用可能なメタデータを持つ型と型のメンバーを含むアセンブリを定義します。
<名前空間>	名前空間内のすべての型にリフレクションポリシーを適用します。
`<Type>`	型とそのすべてのメンバーにリフレクションポリシーを適用します。
<TypeInstantiation>	構築されたジェネリック型とそのすべてのメンバーにリフレクションポリシーを適用します。

解説

リフレクション、シリアル化、および相互運用属性はすべて省略可能です。いずれも存在しない場合、<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>

次の方法で共有

<Type> 要素 (.NET Native)

構文

属性および要素

属性

Name 属性

その他すべての属性

子要素

親要素

解説

例 1

例 2

関連項目

フィードバック

その他のリソース