ParameterInfo.IsOptional プロパティ

定義

名前空間:

System.Reflection

アセンブリ:

System.Runtime.dll

ソース:

ParameterInfo.cs

このパラメーターが省略可能かどうかを示す値を取得します。

C#

public bool IsOptional { get; }

プロパティ値

Boolean

パラメーターが省略可能な場合は true。それ以外の場合は false。

例

次の例は、および ParameterAttributes.Optional 属性のメソッド パラメーターをParameterAttributes.InParameterAttributes.Outテストする方法を示しています。

この例には、次の処理を DefineMethod 行うメソッドが含まれています。

• 型を含む動的アセンブリを MyType 作成します。

• にメソッドを MyMethod 追加します MyType。 MyMethod には 3 つのパラメーターがあります。 最初のパラメーターは、 で ParameterAttributes.In定義され、2 番目のパラメーターは で ParameterAttributes.Out、3 番目のパラメーターは で ParameterAttributes.Optional定義されます。

• を呼び出 TypeBuilder.CreateType して型を完了します。

を DefineMethod実行した後、動的アセンブリが見つかるまで、現在読み込まれているアセンブリを検索します。 アセンブリから読み込みMyType、 メソッドの オブジェクトをMyMethodMethodInfo取得し、パラメーターを調べます。 この例では、、IsOut、および IsOptional プロパティをIsIn使用して、パラメーターに関する情報を表示します。

C#

using System;
using System.Reflection;
using System.Threading;
using System.Reflection.Emit;

public class ParameterInfo_IsIn_IsOut_IsOptional
{
   public static void DefineMethod()
   {
      AssemblyName myAssemblyName = new AssemblyName();
      myAssemblyName.Name = "MyAssembly";
      // Get the assembly builder from the application domain associated with the current thread.
      AssemblyBuilder myAssemblyBuilder = Thread.GetDomain().DefineDynamicAssembly(myAssemblyName, AssemblyBuilderAccess.RunAndSave);
      // Create a dynamic module in the assembly.
      ModuleBuilder myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("MyModule", "MyAssembly.dll");
      // Create a type in the module.
      TypeBuilder myTypeBuilder = myModuleBuilder.DefineType("MyType");
      // Create a method called MyMethod.
      MethodBuilder myMethodBuilder = myTypeBuilder.DefineMethod("MyMethod",MethodAttributes.Public | MethodAttributes.HideBySig |
                                                                           MethodAttributes.Static, typeof(string), new Type[] {typeof(int), typeof(short), typeof(long)});
      // Set the attributes for the parameters of the method.
      // Set the attribute for the first parameter to IN.
      ParameterBuilder myParameterBuilder = myMethodBuilder.DefineParameter(1, ParameterAttributes.In, "MyIntParameter");
      // Set the attribute for the second parameter to OUT.
      myParameterBuilder = myMethodBuilder.DefineParameter(2, ParameterAttributes.Out, "MyShortParameter");
      // Set the attribute for the third parameter to OPTIONAL.
      myParameterBuilder = myMethodBuilder.DefineParameter(3, ParameterAttributes.Optional | ParameterAttributes.HasDefault, "MyLongParameter");
      // Get the Microsoft Intermediate Language generator for the method.
      ILGenerator myILGenerator = myMethodBuilder.GetILGenerator();
      // Use the utility method to generate the MSIL instructions that print a string to the console.
      myILGenerator.EmitWriteLine("Hello World!");
      // Generate the "ret" MSIL instruction.
      myILGenerator.Emit(OpCodes.Ret);
      // End the creation of the type.
      myTypeBuilder.CreateType();
   }

   public static void Main()
   {
      // Create a dynamic assembly with a type named MyType.
      DefineMethod();

      // Get the assemblies currently loaded in the application domain.
      Assembly[] myAssemblies = Thread.GetDomain().GetAssemblies();
      Assembly myAssembly = null;
      // Get the assembly named MyAssembly.
      for(int i = 0; i < myAssemblies.Length; i++)
         if(String.Compare(myAssemblies[i].GetName(false).Name, "MyAssembly") == 0)
            myAssembly = myAssemblies[i];

      if(myAssembly != null)
      {
         // Get a type named MyType.
         Type myType = myAssembly.GetType("MyType");
         // Get a method named MyMethod from the type.
         MethodBase myMethodBase = myType.GetMethod("MyMethod");
         // Get the parameters associated with the method.
         ParameterInfo[] myParameters = myMethodBase.GetParameters();
         Console.WriteLine("\nThe method {0} has the {1} parameters :",
            myMethodBase, myParameters.Length);
         // Print the IN, OUT and OPTIONAL attributes associated with each of the parameters.
         for(int i = 0; i < myParameters.Length; i++)
         {
            if(myParameters[i].IsIn)
               Console.WriteLine("\tThe {0} parameter has the In attribute",
                                       i + 1);
            if(myParameters[i].IsOptional)
               Console.WriteLine("\tThe {0} parameter has the Optional attribute",
                                       i + 1);
            if(myParameters[i].IsOut)
               Console.WriteLine("\tThe {0} parameter has the Out attribute",
                                       i + 1);
         }
      }
      else
        {
            Console.WriteLine("Could not find a assembly named 'MyAssembly' for the current application domain");
        }
    }
}

注釈

このメソッドは、省略可能なメタデータ フラグに依存します。 このフラグはコンパイラによって挿入できますが、コンパイラには必須ではありません。

このメソッドは、列挙子の Optional フラグを ParameterAttributes 使用します。

配列を ParameterInfo 取得するには、まず メソッドを取得してから を呼び出 MethodBase.GetParametersします。

適用対象