BindingFlags 列挙体
バインディング、およびリフレクションによるメンバと型の検索方法を制御するフラグを指定します。
この列挙体には、メンバ値をビットごとに演算するための FlagsAttribute 属性が含まれています。
<Flags>
<Serializable>
Public Enum BindingFlags
[C#]
[Flags]
[Serializable]
public enum BindingFlags
[C++]
[Flags]
[Serializable]
__value public enum BindingFlags
[JScript]
public
Flags
Serializable
enum BindingFlags
解説
これらの BindingFlags は、メンバと型の呼び出し、作成、取得、設定、および検索を行う System 、 System.Reflection 、 System.Runtime の各名前空間の多くのクラスのバインディングを制御します。
BindingFlags は、次の Type メソッドや MethodBase.Invoke などで使用します。
- MethodBase.Invoke
- GetMembers
- GetEvents
- InvokeMember
- Activator.CreateInstance
- GetConstructor
- GetConstructors
- GetMethod
- GetMethods
- GetField
- GetFields
- GetEvent
- GetProperty
- GetProperties
- GetMember
- FindMembers
InvokeMember と GetMethod は、特に重要です。
バインディング フラグは次のように分類されます。
| バインディング フラグ | 目的 |
|---|---|
| DeclaredOnly | アクセシビリティによるメンバの特定 |
| FlattenHierarchy | アクセシビリティによるメンバの特定 |
| IgnoreCase | アクセシビリティによるメンバの特定 |
| IgnoreReturn | アクセシビリティによるメンバの特定 |
| Instance | アクセシビリティによるメンバの特定 |
| NonPublic | アクセシビリティによるメンバの特定 |
| Public | アクセシビリティによるメンバの特定 |
| Static | アクセシビリティによるメンバの特定 |
| ExactBinding | 引数によるメンバの特定 |
| OptionalParamBinding | 引数によるメンバの特定 |
| CreateInstance | 操作 |
| GetField | 操作 |
| SetField | 操作 |
| GetProperty | 操作 |
| SetProperty | 操作 |
| InvokeMethod | 操作 |
| PutDispProperty | 操作 |
| PutRefDispProperty | 操作 |
メモ Public または NonPublic と共に、Instance または Static を指定する必要があります。指定しない場合、メンバが返されません。
既定の Binder.ChangeType で実行される型の強制変換の一覧を次の表に示します。この表は、特に ExactBinding バインディング フラグに適用されます。
| 変換元の型 | 変換後の型 |
|---|---|
| 任意の型 | 基本型 |
| 任意の型 | 実装するインターフェイス |
| Char | UInt16, UInt32, Int32, UInt64, Int64, Single, Double |
| Byte | Char, UInt16, Int16, UInt32, Int32, UInt64, Int64, Single, Double |
| SByte | Int16, Int32, Int64, Single, Double |
| UInt16 | UInt32, Int32, UInt64, Int64, Single, Double |
| Int16 | Int32, Int64, Single, Double |
| UInt32 | UInt64, Int64, Single, Double |
| Int32 | Int64, Single, Double |
| UInt64 | Single, Double |
| Int64 | Single, Double |
| Single | Double |
| 非参照渡し | 参照渡し |
メンバ
| メンバ名 | 説明 | 値 |
|---|---|---|
| CreateInstance
.NET Compact Framework でもサポート。 |
リフレクションが指定した型のインスタンスを作成するように指定します。指定した引数と一致するコンストラクタを呼び出します。指定したメンバ名は無視されます。検索の種類を省略した場合は、(Instance | Public) が適用されます。タイプ初期化子を呼び出すことはできません。 | 512 |
| DeclaredOnly
.NET Compact Framework でもサポート。 |
指定した型の階層のレベルで宣言されたメンバだけが対象になるように指定します。継承されたメンバは対象になりません。 | 2 |
| Default
.NET Compact Framework でもサポート。 |
バインディング フラグを指定しません。 | 0 |
| ExactBinding
.NET Compact Framework でもサポート。 |
指定した引数の型が、対応する仮パラメータの型と完全に一致する必要があることを指定します。呼び出し元が非 null Binder オブジェクトを指定した場合、これは適切なメソッドをピックする BindToXXX 実装を呼び出し元が提供することを意味するため、リフレクションは例外をスローします。
リフレクションは、共通の型システムにおけるアクセスに関する規則をモデル化します。たとえば、呼び出し元が同一アセンブリ内にある場合、呼び出し元に内部メンバに対する特別なアクセス許可は必要ありません。それ以外の場合は、呼び出し元に ReflectionPermission が必要です。このことは、プロテクト メンバ、プライベート メンバなどを検索する場合も同様です。 一般原則として、データを失わないように、 ChangeType は型の強制拡大変換だけを実行します。型の強制拡大変換の例としては、32 ビット符号付き整数値から 64 ビット符号付き整数値への強制変換があります。この変換は、データが失われる可能性がある、型の強制縮小変換とは区別されます。型の強制縮小変換の例としては、64 ビット符号付き整数から 32 ビット符号付き整数への強制変換があります。 既定のバインダはこのフラグを無視しますが、カスタム バインダはこのフラグのセマンティクスを実装できます。 |
65536 |
| FlattenHierarchy
.NET Compact Framework でもサポート。 |
階層上位の静的メンバを返す場合に指定します。静的メンバには、フィールド、メソッド、イベント、プロパティなどがあります。入れ子になった型は返されません。 | 64 |
| GetField
.NET Compact Framework でもサポート。 |
指定したフィールドの値を返すように指定します。 | 1024 |
| GetProperty
.NET Compact Framework でもサポート。 |
指定したプロパティの値を返すように指定します。 | 4096 |
| IgnoreCase
.NET Compact Framework でもサポート。 |
バインディングのときにメンバ名の大文字小文字を区別しないように指定します。 | 1 |
| IgnoreReturn
.NET Compact Framework でもサポート。 |
COM 相互運用で使用して、メンバの戻り値を無視できることを指定します。 | 16777216 |
| Instance
.NET Compact Framework でもサポート。 |
インスタンス メンバを検索に含めるように指定します。 | 4 |
| InvokeMethod
.NET Compact Framework でもサポート。 |
メソッドを呼び出すように指定します。コンストラクタとタイプ初期化子は指定できません。 | 256 |
| NonPublic
.NET Compact Framework でもサポート。 |
非パブリック メンバを検索に含めるように指定します。 | 32 |
| OptionalParamBinding
.NET Compact Framework でもサポート。 |
パラメータ数が指定された引数の数と一致するメンバのセットを返します。このバインディング フラグは、既定値を持つパラメータをとるメソッドと、可変個の引数 (varargs) をとるメソッドで使用します。このフラグを使用するときは、必ず Type.InvokeMember も使用します。
既定値を持つパラメータを呼び出しで使用できるのは、それ以後の引数が省略されている場合だけです。そのパラメータが最後の引数になります。 |
262144 |
| Public
.NET Compact Framework でもサポート。 |
パブリック メンバを検索に含めるように指定します。 | 16 |
| PutDispProperty
.NET Compact Framework でもサポート。 |
COM オブジェクトの PROPPUT メンバを呼び出す必要があることを指定します。 PROPPUT は、値を使用するプロパティ設定関数を指定します。プロパティに PROPPUT と PROPPUTREF の両方があり、どちらを呼び出すかを区別する必要がある場合は、 PutDispProperty を使用します。 | 16384 |
| PutRefDispProperty
.NET Compact Framework でもサポート。 |
COM オブジェクトの PROPPUTREF メンバを呼び出す必要があることを指定します。 PROPPUTREF は、値の代わりに参照を使用するプロパティ設定関数を指定します。プロパティに PROPPUT と PROPPUTREF の両方があり、どちらを呼び出すかを区別する必要がある場合は、 PutRefDispProperty を使用します。 | 32768 |
| SetField
.NET Compact Framework でもサポート。 |
指定したフィールドの値を設定するように指定します。 | 2048 |
| SetProperty
.NET Compact Framework でもサポート。 |
指定したプロパティの値を設定するように指定します。COM プロパティの場合、このバインディング フラグを指定することは、 PutDispProperty と PutRefDispProperty を指定することと同じです。 | 8192 |
| Static
.NET Compact Framework でもサポート。 |
静的メンバを検索に含めるように指定します。 | 8 |
| SuppressChangeType
.NET Compact Framework でもサポート。 |
実装されていません。 | 131072 |
使用例
[Visual Basic, C#, C++] 各バインディング フラグの例を次に示します。
Imports System
Imports System.Reflection
Imports System.IO
Class EntryPoint
Overloads Shared Sub Main(ByVal args() As String)
Invoke.Go()
End Sub 'Main
End Class 'EntryPoint
Class Invoke
Public Shared Sub Go()
' BindingFlags.InvokeMethod
' Call a static method.
Dim t As Type = GetType(TestClass)
Console.WriteLine()
Console.WriteLine("Invoking a static method.")
Console.WriteLine("-------------------------")
t.InvokeMember("SayHello", BindingFlags.InvokeMethod, Nothing, Nothing, New Object() {})
' BindingFlags.InvokeMethod
' Call an instance method.
Dim c As New TestClass()
Console.WriteLine()
Console.WriteLine("Invoking an instance method.")
Console.WriteLine("----------------------------")
c.GetType().InvokeMember("AddUp", BindingFlags.InvokeMethod, Nothing, c, New Object() {})
c.GetType().InvokeMember("AddUp", BindingFlags.InvokeMethod, Nothing, c, New Object() {})
' BindingFlags.InvokeMethod
' Call a method with parameters.
Dim args() As Object = {100.09, 184.45}
Dim result As Object
Console.WriteLine()
Console.WriteLine("Invoking a method with parameters.")
Console.WriteLine("---------------------------------")
result = t.InvokeMember("ComputeSum", BindingFlags.InvokeMethod, Nothing, Nothing, args)
Console.WriteLine("{0} + {1} = {2}", args(0), args(1), result)
' BindingFlags.GetField, SetField
Console.WriteLine()
Console.WriteLine("Invoking a field (getting and setting.)")
Console.WriteLine("--------------------------------------")
' Get a field value.
result = t.InvokeMember("Name", BindingFlags.GetField, Nothing, c, New Object() {})
Console.WriteLine("Name == {0}", result)
' Set a field.
t.InvokeMember("Name", BindingFlags.SetField, Nothing, c, New Object() {"NewName"})
result = t.InvokeMember("Name", BindingFlags.GetField, Nothing, c, New Object() {})
Console.WriteLine("Name == {0}", result)
Console.WriteLine()
Console.WriteLine("Invoking an indexed property (getting and setting.)")
Console.WriteLine("--------------------------------------------------")
' BindingFlags.GetProperty
' Get an indexed property value.
Dim index As Integer = 3
result = t.InvokeMember("Item", BindingFlags.GetProperty, Nothing, c, New Object() {index})
Console.WriteLine("Item[{0}] == {1}", index, result)
' BindingFlags.SetProperty
' Set an indexed property value.
index = 3
t.InvokeMember("Item", BindingFlags.SetProperty, Nothing, c, New Object() {index, "NewValue"})
result = t.InvokeMember("Item", BindingFlags.GetProperty, Nothing, c, New Object() {index})
Console.WriteLine("Item[{0}] == {1}", index, result)
Console.WriteLine()
Console.WriteLine("Getting a field or property.")
Console.WriteLine("----------------------------")
' BindingFlags.GetField
' Get a field or property.
result = t.InvokeMember("Name", BindingFlags.GetField Or BindingFlags.GetProperty, Nothing, c, New Object() {})
Console.WriteLine("Name == {0}", result)
' BindingFlags.GetProperty
result = t.InvokeMember("Value", BindingFlags.GetField Or BindingFlags.GetProperty, Nothing, c, New Object() {})
Console.WriteLine("Value == {0}", result)
Console.WriteLine()
Console.WriteLine("Invoking a method with named parameters.")
Console.WriteLine("---------------------------------------")
' BindingFlags.InvokeMethod
' Call a method using named parameters.
Dim argValues() As Object = {"Mouse", "Micky"}
Dim argNames() As [String] = {"lastName", "firstName"}
t.InvokeMember("PrintName", BindingFlags.InvokeMethod, Nothing, Nothing, argValues, Nothing, Nothing, argNames)
Console.WriteLine()
Console.WriteLine("Invoking a default member of a type.")
Console.WriteLine("------------------------------------")
' BindingFlags.Default
' Call the default member of a type.
Dim t3 As Type = GetType(TestClass2)
t3.InvokeMember("", BindingFlags.InvokeMethod Or BindingFlags.Default, Nothing, New TestClass2(), New Object() {})
Console.WriteLine()
Console.WriteLine("Invoking a method by reference.")
Console.WriteLine("-------------------------------")
' BindingFlags.Static, NonPublic, and Public
' Invoking a member by reference.
Dim m As MethodInfo = t.GetMethod("Swap")
args = New Object(1) {}
args(0) = 1
args(1) = 2
m.Invoke(New TestClass(), args)
Console.WriteLine("{0}, {1}", args(0), args(1))
' The string is case-sensitive.
Dim type As Type = type.GetType("System.String")
' Check to see if the value is valid. If the object is null, the type does not exist.
If type Is Nothing Then
Console.WriteLine("Please ensure that you specify only valid types in the type field.")
Console.WriteLine("The type name is case-sensitive.")
Return
End If
' Declare and populate the arrays to hold the information.
' You must declare either NonPublic or Public with Static or the search will not work.
Dim fi As FieldInfo() = type.GetFields((BindingFlags.Static Or BindingFlags.NonPublic Or BindingFlags.Public))
' BindingFlags.NonPublic
Dim miNonPublic As MethodInfo() = type.GetMethods((BindingFlags.Static Or BindingFlags.NonPublic))
' BindingFlags.Public
Dim miPublic As MethodInfo() = type.GetMethods((BindingFlags.Static Or BindingFlags.Public))
' Iterate through all the nonpublic methods.
Dim method As MethodInfo
For Each method In miNonPublic
Console.WriteLine(method)
Next method
' Iterate through all the public methods.
For Each method In miPublic
Console.WriteLine(method)
Next method
' Iterate through all the fields.
Dim f As FieldInfo
For Each f In fi
Console.WriteLine(f)
Next f
' Call an instance method.
Dim tc As New TestClass()
Console.WriteLine()
Console.WriteLine("Invoking an Instance method.")
Console.WriteLine("----------------------------")
tc.GetType().InvokeMember("AddUp", BindingFlags.Public Or BindingFlags.Instance Or BindingFlags.CreateInstance, Nothing, tc, New Object() {})
' BindingFlags.CreateInstance
' Calling and creating an instance method.
Console.WriteLine()
Console.WriteLine("Invoking and creating an instance method.")
Console.WriteLine("-----------------------------------------")
tc.GetType().InvokeMember("AddUp", BindingFlags.Public Or BindingFlags.Instance Or BindingFlags.CreateInstance, Nothing, tc, New Object() {})
' BindingFlags.DeclaredOnly
Dim tc2 As New TestClass()
Console.WriteLine()
Console.WriteLine("DeclaredOnly members")
Console.WriteLine("---------------------------------")
Dim memInfo As System.Reflection.MemberInfo() = tc2.GetType().GetMembers(BindingFlags.DeclaredOnly)
Dim i As Integer
For i = 0 To memInfo.Length - 1
Console.WriteLine(memInfo(i).Name)
Next i
' BindingFlags.SuppressChangeType
Dim obj As New TestClass()
Console.WriteLine()
Console.WriteLine("Invoking static method - PrintName")
Console.WriteLine("---------------------------------")
Dim methInfo As System.Reflection.MethodInfo = obj.GetType().GetMethod("PrintName")
methInfo.Invoke(obj, BindingFlags.SuppressChangeType Or BindingFlags.InvokeMethod, Nothing, New Object() {"Brad", "Smith"}, Nothing)
' BindingFlags.IgnoreCase
Console.WriteLine()
Console.WriteLine("Using IgnoreCase and invoking the PrintName method.")
Console.WriteLine("---------------------------------------------------")
methInfo = obj.GetType().GetMethod("PrintName")
methInfo.Invoke(obj, BindingFlags.IgnoreCase Or BindingFlags.InvokeMethod, Nothing, New Object() {"brad", "smith"}, Nothing)
' BindingFlags.IgnoreReturn
Console.WriteLine()
Console.WriteLine("Using IgnoreReturn and invoking the PrintName method.")
Console.WriteLine("-----------------------------------------------------")
methInfo = obj.GetType().GetMethod("PrintName")
methInfo.Invoke(obj, BindingFlags.IgnoreReturn Or BindingFlags.InvokeMethod, Nothing, New Object() {"Brad", "Smith"}, Nothing)
' BindingFlags.OptionalParamBinding
Console.WriteLine()
Console.WriteLine("Using OptionalParamBinding and invoking the PrintName method.")
Console.WriteLine("-------------------------------------------------------------")
methInfo = obj.GetType().GetMethod("PrintName")
methInfo.Invoke(obj, BindingFlags.OptionalParamBinding Or BindingFlags.InvokeMethod, Nothing, New Object() {"Brad", "Smith"}, Nothing)
' BindingFlags.ExactBinding
Console.WriteLine()
Console.WriteLine("Using ExactBinding and invoking the PrintName method.")
Console.WriteLine("-----------------------------------------------------")
methInfo = obj.GetType().GetMethod("PrintName")
methInfo.Invoke(obj, BindingFlags.ExactBinding Or BindingFlags.InvokeMethod, Nothing, New Object() {"Brad", "Smith"}, Nothing)
' BindingFlags.FlattenHierarchy
Console.WriteLine()
Console.WriteLine("Using FlattenHierarchy and invoking the PrintName method.")
Console.WriteLine("---------------------------------------------------------")
methInfo = obj.GetType().GetMethod("PrintName")
methInfo.Invoke(obj, BindingFlags.FlattenHierarchy Or BindingFlags.InvokeMethod, Nothing, New Object() {"Brad", "Smith"}, Nothing)
End Sub 'Go
End Class 'Invoke
Public Class TestClass
Public Name As [String]
Private values() As [Object] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}
Default Public Property Item(ByVal index As Integer) As [Object]
Get
Return values(index)
End Get
Set(ByVal Value As [Object])
values(index) = Value
End Set
End Property
Public ReadOnly Property Value() As [Object]
Get
Return "the value"
End Get
End Property
Public Sub New()
Name = "initialName"
End Sub 'New
Private methodCalled As Integer = 0
Public Shared Sub SayHello()
Console.WriteLine("Hello")
End Sub 'SayHello
Public Sub AddUp()
methodCalled += 1
Console.WriteLine("AddUp Called {0} times", methodCalled)
End Sub 'AddUp
Public Shared Function ComputeSum(ByVal d1 As Double, ByVal d2 As Double) As Double
Return d1 + d2
End Function 'ComputeSum
Public Shared Sub PrintName(ByVal firstName As [String], ByVal lastName As [String])
Console.WriteLine("{0},{1}", lastName, firstName)
End Sub 'PrintName
Public Sub PrintTime()
Console.WriteLine(DateTime.Now)
End Sub 'PrintTime
Public Sub Swap(ByRef a As Integer, ByRef b As Integer)
Dim x As Integer = a
a = b
b = x
End Sub 'Swap
End Class 'TestClass
<DefaultMemberAttribute("PrintTime")> _
Public Class TestClass2
Public Sub PrintTime()
Console.WriteLine(DateTime.Now)
End Sub 'PrintTime
End Class 'TestClass2
[C#]
using System;
using System.Reflection;
using System.IO;
namespace BindingFlagsSnippet
{
class EntryPoint
{
static void Main(string[] args)
{
Invoke.Go();
}
}
class Invoke
{
public static void Go()
{
// BindingFlags.InvokeMethod
// Call a static method.
Type t = typeof (TestClass);
Console.WriteLine();
Console.WriteLine("Invoking a static method.");
Console.WriteLine("-------------------------");
t.InvokeMember ("SayHello", BindingFlags.InvokeMethod, null, null, new object [] {});
// BindingFlags.InvokeMethod
// Call an instance method.
TestClass c = new TestClass ();
Console.WriteLine();
Console.WriteLine("Invoking an instance method.");
Console.WriteLine("----------------------------");
c.GetType().InvokeMember ("AddUp", BindingFlags.InvokeMethod, null, c, new object [] {});
c.GetType().InvokeMember ("AddUp", BindingFlags.InvokeMethod, null, c, new object [] {});
// BindingFlags.InvokeMethod
// Call a method with parameters.
object [] args = new object [] {100.09, 184.45};
object result;
Console.WriteLine();
Console.WriteLine("Invoking a method with parameters.");
Console.WriteLine("---------------------------------");
result = t.InvokeMember ("ComputeSum", BindingFlags.InvokeMethod, null, null, args);
Console.WriteLine ("{0} + {1} = {2}", args[0], args[1], result);
// BindingFlags.GetField, SetField
Console.WriteLine();
Console.WriteLine("Invoking a field (getting and setting.)");
Console.WriteLine("--------------------------------------");
// Get a field value.
result = t.InvokeMember ("Name", BindingFlags.GetField, null, c, new object [] {});
Console.WriteLine ("Name == {0}", result);
// Set a field.
t.InvokeMember ("Name", BindingFlags.SetField, null, c, new object [] {"NewName"});
result = t.InvokeMember ("Name", BindingFlags.GetField, null, c, new object [] {});
Console.WriteLine ("Name == {0}", result);
Console.WriteLine();
Console.WriteLine("Invoking an indexed property (getting and setting.)");
Console.WriteLine("--------------------------------------------------");
// BindingFlags.GetProperty
// Get an indexed property value.
int index = 3;
result = t.InvokeMember ("Item", BindingFlags.GetProperty, null, c, new object [] {index});
Console.WriteLine ("Item[{0}] == {1}", index, result);
// BindingFlags.SetProperty
// Set an indexed property value.
index = 3;
t.InvokeMember ("Item", BindingFlags.SetProperty, null, c, new object [] {index, "NewValue"});
result = t.InvokeMember ("Item", BindingFlags.GetProperty , null, c, new object [] {index});
Console.WriteLine ("Item[{0}] == {1}", index, result);
Console.WriteLine();
Console.WriteLine("Getting a field or property.");
Console.WriteLine("----------------------------");
// BindingFlags.GetField
// Get a field or property.
result = t.InvokeMember ("Name", BindingFlags.GetField | BindingFlags.GetProperty, null, c, new object [] {});
Console.WriteLine ("Name == {0}", result);
// BindingFlags.GetProperty
result = t.InvokeMember ("Value", BindingFlags.GetField | BindingFlags.GetProperty, null, c, new object [] {});
Console.WriteLine ("Value == {0}", result);
Console.WriteLine();
Console.WriteLine("Invoking a method with named parameters.");
Console.WriteLine("---------------------------------------");
// BindingFlags.InvokeMethod
// Call a method using named parameters.
object[] argValues = new object [] {"Mouse", "Micky"};
String [] argNames = new String [] {"lastName", "firstName"};
t.InvokeMember ("PrintName", BindingFlags.InvokeMethod, null, null, argValues, null, null, argNames);
Console.WriteLine();
Console.WriteLine("Invoking a default member of a type.");
Console.WriteLine("------------------------------------");
// BindingFlags.Default
// Call the default member of a type.
Type t3 = typeof (TestClass2);
t3.InvokeMember ("", BindingFlags.InvokeMethod | BindingFlags.Default, null, new TestClass2(), new object [] {});
// BindingFlags.Static, NonPublic, and Public
// Invoking a member by reference.
Console.WriteLine();
Console.WriteLine("Invoking a method by reference.");
Console.WriteLine("-------------------------------");
MethodInfo m = t.GetMethod("Swap");
args = new object[2];
args[0] = 1;
args[1] = 2;
m.Invoke(new TestClass(),args);
Console.WriteLine ("{0}, {1}", args[0], args[1]);
// The string is case-sensitive.
Type type = Type.GetType("System.String");
// Check to see if the value is valid. If the object is null, the type does not exist.
if (type == null)
{
Console.WriteLine("Please ensure that you specify only valid types in the type field.");
Console.WriteLine("The type name is case-sensitive.");
return;
}
// Declare and populate the arrays to hold the information.
// You must declare either NonPublic or Public with Static or the search will not work.
FieldInfo [] fi = type.GetFields (BindingFlags.Static |
BindingFlags.NonPublic | BindingFlags.Public);
// BindingFlags.NonPublic
MethodInfo [] miNonPublic = type.GetMethods (BindingFlags.Static |
BindingFlags.NonPublic);
// BindingFlags.Public
MethodInfo [] miPublic = type.GetMethods (BindingFlags.Static |
BindingFlags.Public);
// Iterate through all the nonpublic methods.
foreach (MethodInfo method in miNonPublic)
{
Console.WriteLine(method);
}
// Iterate through all the public methods.
foreach (MethodInfo method in miPublic)
{
Console.WriteLine(method);
}
// Iterate through all the fields.
foreach (FieldInfo f in fi)
{
Console.WriteLine(f);
}
// BindingFlags.Instance
// Call an instance method.
TestClass tc = new TestClass ();
Console.WriteLine();
Console.WriteLine("Invoking an Instance method.");
Console.WriteLine("----------------------------");
tc.GetType().InvokeMember ("AddUp", BindingFlags.Public |
BindingFlags.Instance | BindingFlags.CreateInstance,
null, tc, new object [] {});
// BindingFlags.CreateInstance
// Calling and creating an instance method.
Console.WriteLine();
Console.WriteLine("Invoking and creating an instance method.");
Console.WriteLine("-----------------------------------------");
tc.GetType().InvokeMember ("AddUp", BindingFlags.Public |
BindingFlags.Instance | BindingFlags.CreateInstance,
null, tc, new object [] {});
// BindingFlags.DeclaredOnly
TestClass tc2 = new TestClass();
Console.WriteLine();
Console.WriteLine("DeclaredOnly members");
Console.WriteLine("---------------------------------");
System.Reflection.MemberInfo[] memInfo =
tc2.GetType().GetMembers(BindingFlags.DeclaredOnly);
for(int i=0;i<memInfo.Length;i++)
{
Console.WriteLine(memInfo[i].Name);
}
// BindingFlags.SuppressChangeType
TestClass obj = new TestClass();
Console.WriteLine();
Console.WriteLine("Invoking static method - PrintName");
Console.WriteLine("---------------------------------");
System.Reflection.MethodInfo methInfo =
obj.GetType().GetMethod("PrintName");
methInfo.Invoke(obj,BindingFlags.SuppressChangeType |
BindingFlags.InvokeMethod, null,new object[]
{"Brad","Smith"},null);
// BindingFlags.IgnoreCase
Console.WriteLine();
Console.WriteLine("Using IgnoreCase and invoking the PrintName method.");
Console.WriteLine("---------------------------------------------------");
methInfo = obj.GetType().GetMethod("PrintName");
methInfo.Invoke(obj,BindingFlags.IgnoreCase |
BindingFlags.InvokeMethod, null,new object[]
{"brad","smith"},null);
// BindingFlags.IgnoreReturn
Console.WriteLine();
Console.WriteLine("Using IgnoreReturn and invoking the PrintName method.");
Console.WriteLine("-----------------------------------------------------");
methInfo = obj.GetType().GetMethod("PrintName");
methInfo.Invoke(obj,BindingFlags.IgnoreReturn |
BindingFlags.InvokeMethod, null,new object[]
{"Brad","Smith"},null);
// BindingFlags.OptionalParamBinding
Console.WriteLine();
Console.WriteLine("Using OptionalParamBinding and invoking the PrintName method.");
Console.WriteLine("-------------------------------------------------------------");
methInfo = obj.GetType().GetMethod("PrintName");
methInfo.Invoke(obj,BindingFlags.OptionalParamBinding |
BindingFlags.InvokeMethod, null,new object[]
{"Brad","Smith"},null);
// BindingFlags.ExactBinding
Console.WriteLine();
Console.WriteLine("Using ExactBinding and invoking the PrintName method.");
Console.WriteLine("-----------------------------------------------------");
methInfo = obj.GetType().GetMethod("PrintName");
methInfo.Invoke(obj,BindingFlags.ExactBinding |
BindingFlags.InvokeMethod, null,new object[]
{"Brad","Smith"},null);
// BindingFlags.FlattenHierarchy
Console.WriteLine();
Console.WriteLine("Using FlattenHierarchy and invoking the PrintName method.");
Console.WriteLine("---------------------------------------------------------");
methInfo = obj.GetType().GetMethod("PrintName");
methInfo.Invoke(obj,BindingFlags.FlattenHierarchy |
BindingFlags.InvokeMethod, null,new object[]
{"Brad","Smith"},null);
}
}
public class TestClass
{
public String Name;
private Object [] values = new Object [] {0, 1,2,3,4,5,6,7,8,9};
public Object this [int index]
{
get
{
return values[index];
}
set
{
values[index] = value;
}
}
public Object Value
{
get
{
return "the value";
}
}
public TestClass ()
{
Name = "initialName";
}
int methodCalled = 0;
public static void SayHello ()
{
Console.WriteLine ("Hello");
}
public void AddUp ()
{
methodCalled++;
Console.WriteLine ("AddUp Called {0} times", methodCalled);
}
public static double ComputeSum (double d1, double d2)
{
return d1 + d2;
}
public static void PrintName (String firstName, String lastName)
{
Console.WriteLine ("{0},{1}", lastName,firstName);
}
public void PrintTime ()
{
Console.WriteLine (DateTime.Now);
}
public void Swap(ref int a, ref int b)
{
int x = a;
a = b;
b = x;
}
}
[DefaultMemberAttribute ("PrintTime")]
public class TestClass2
{
public void PrintTime ()
{
Console.WriteLine (DateTime.Now);
}
}
}
[C++]
#using <mscorlib.dll>
using namespace System;
using namespace System::Collections;
using namespace System::Reflection;
using namespace System::IO;
//namespace BindingFlagsSnippet {
public __gc class TestClass
{
public:
String* Name;
private:
Object* values[];
public:
__property Object* get_Item(int index)
{
return values->Item[index];
}
__property void set_Item(int index, Object* value)
{
values->Item[index] = value;
}
__property Object* get_Value() {
return S"the value";
}
int methodCalled;
TestClass ()
{
Name = S"initialName";
Object* o[] = {__box(0), __box(1), __box(2), __box(3), __box(4),
__box(5), __box(6), __box(7), __box(8), __box(9)};
values = o;
methodCalled = 0;
}
static void SayHello () {
Console::WriteLine (S"Hello");
}
void AddUp () {
methodCalled++;
Console::WriteLine (S"AddUp Called {0} times", __box(methodCalled));
}
static double ComputeSum (double d1, double d2) {
return d1 + d2;
}
static void PrintName (String* firstName, String* lastName) {
Console::WriteLine (S"{0},{1}", lastName, firstName);
}
void PrintTime () {
Console::WriteLine (__box(DateTime::Now));
}
void Swap(int __gc* a, int __gc* b) {
int x = *a;
*a = *b;
*b = x;
}
};
[DefaultMemberAttribute (S"PrintTime")]
public __gc class TestClass2
{
public:
void PrintTime () {
Console::WriteLine (__box(DateTime::Now));
}
};
class Invoke
{
public:
static void Go()
{
// BindingFlags::InvokeMethod
// Call a static method.
Type* t = __typeof (TestClass);
Console::WriteLine();
Console::WriteLine(S"Invoking a static method.");
Console::WriteLine(S"-------------------------");
Object* obj1[];
t->InvokeMember (S"SayHello", BindingFlags::InvokeMethod, 0, 0, obj1);
// BindingFlags::InvokeMethod
// Call an instance method.
TestClass* c = new TestClass ();
Console::WriteLine();
Console::WriteLine(S"Invoking an instance method.");
Console::WriteLine(S"----------------------------");
c->GetType()->InvokeMember (S"AddUp", BindingFlags::InvokeMethod, 0, c, obj1);
c->GetType()->InvokeMember (S"AddUp", BindingFlags::InvokeMethod, 0, c, obj1);
// BindingFlags::InvokeMethod
// Call a method with parameters.
Object* args[] = {__box(100.09), __box(184.45)};
Object* result;
Console::WriteLine();
Console::WriteLine(S"Invoking a method with parameters.");
Console::WriteLine(S"---------------------------------");
result = t->InvokeMember (S"ComputeSum", BindingFlags::InvokeMethod, 0, 0, args);
Console::WriteLine (S" {0} + {1} = {2}", args->Item[0], args->Item[1], result);
// BindingFlags::GetField, SetField
Console::WriteLine();
Console::WriteLine(S"Invoking a field (getting and setting.)");
Console::WriteLine(S"--------------------------------------");
// Get a field value.
result = t->InvokeMember (S"Name", BindingFlags::GetField, 0, c, obj1);
Console::WriteLine (S"Name == {0}", result);
// Set a field.
Object* obj2[] = {S"NewName"};
t->InvokeMember (S"Name", BindingFlags::SetField, 0, c, obj2);
result = t->InvokeMember (S"Name", BindingFlags::GetField, 0, c, obj1);
Console::WriteLine (S"Name == {0}", result);
Console::WriteLine();
Console::WriteLine(S"Invoking an indexed property (getting and setting.)");
Console::WriteLine(S"--------------------------------------------------");
// BindingFlags::GetProperty
// Get an indexed property value.
int index = 3;
Object* obj3[] = {__box(index)};
result = t->InvokeMember (S"Item", BindingFlags::GetProperty, 0, c, obj3);
Console::WriteLine (S"Item->Item[ {0}] == {1}", __box(index), result);
// BindingFlags::SetProperty
// Set an indexed property value.
index = 3;
Object* obj4[] = {__box(index), S"NewValue"};
t->InvokeMember (S"Item", BindingFlags::SetProperty, 0, c, obj4);
result = t->InvokeMember (S"Item", BindingFlags::GetProperty , 0, c, obj3);
Console::WriteLine (S"Item->Item[ {0}] == {1}", __box(index), result);
Console::WriteLine();
Console::WriteLine(S"Getting a field or property.");
Console::WriteLine(S"----------------------------");
// BindingFlags::GetField
// Get a field or property.
result = t->InvokeMember (S"Name",
static_cast<BindingFlags>(BindingFlags::GetField | BindingFlags::GetProperty),
0, c, obj1);
Console::WriteLine (S"Name == {0}", result);
// BindingFlags::GetProperty
result = t->InvokeMember (S"Value",
static_cast<BindingFlags>(BindingFlags::GetField | BindingFlags::GetProperty),
0, c, obj1);
Console::WriteLine (S"Value == {0}", result);
Console::WriteLine();
Console::WriteLine(S"Invoking a method with named parameters.");
Console::WriteLine(S"---------------------------------------");
// BindingFlags::InvokeMethod
// Call a method using named parameters.
Object* argValues[] = {S"Mouse", S"Micky"};
String* argNames[] = {S"lastName", S"firstName"};
t->InvokeMember (S"PrintName", BindingFlags::InvokeMethod, 0, 0, argValues, 0, 0, argNames);
Console::WriteLine();
Console::WriteLine(S"Invoking a default member of a type.");
Console::WriteLine(S"------------------------------------");
// BindingFlags::Default
// Call the default member of a type.
Type* t3 = __typeof (TestClass2);
t3->InvokeMember (S"", static_cast<BindingFlags>(BindingFlags::InvokeMethod | BindingFlags::Default), 0, new TestClass2(), obj1);
// BindingFlags::Static, NonPublic, and Public
// Invoking a member by reference.
Console::WriteLine();
Console::WriteLine(S"Invoking a method by reference.");
Console::WriteLine(S"-------------------------------");
MethodInfo* m = t->GetMethod(S"Swap");
args = new Object*[2];
args[0] = __box(1);
args[1] = __box(2);
m->Invoke(new TestClass(), args);
Console::WriteLine (S"{0}, {1}", args->Item[0], args->Item[1]);
// The String* is case-sensitive.
Type* type = Type::GetType(S"System.String");
// Check to see if the value is valid. If the Object* is 0, the type does not exist.
if (type == 0) {
Console::WriteLine(S"Please ensure that you specify only valid types in the type field.");
Console::WriteLine(S"The type name is case-sensitive.");
return;
}
// Declare and populate the arrays to hold the information.
// You must declare either NonPublic or Public with Static or the search will not work.
FieldInfo* fi[] = type->GetFields (static_cast<BindingFlags>(BindingFlags::Static |
BindingFlags::NonPublic | BindingFlags::Public));
// BindingFlags::NonPublic
MethodInfo* miNonPublic[] = type->GetMethods (static_cast<BindingFlags>(BindingFlags::Static |
BindingFlags::NonPublic));
// BindingFlags::Public
MethodInfo* miPublic[] = type->GetMethods (static_cast<BindingFlags>(BindingFlags::Static |
BindingFlags::Public));
// Iterate through all the nonpublic methods.
IEnumerator* myEnum1 = miNonPublic->GetEnumerator();
while (myEnum1->MoveNext()) {
MethodInfo* method = __try_cast<MethodInfo*>(myEnum1->Current);
Console::WriteLine(method);
}
// Iterate through all the public methods.
IEnumerator* myEnum2 = miPublic->GetEnumerator();
while (myEnum2->MoveNext()) {
MethodInfo* method = __try_cast<MethodInfo*>(myEnum2->Current);
Console::WriteLine(method);
}
// Iterate through all the fields.
IEnumerator* myEnum3 = fi->GetEnumerator();
while (myEnum3->MoveNext()) {
FieldInfo* f = __try_cast<FieldInfo*>(myEnum3->Current);
Console::WriteLine(f);
}
// BindingFlags::Instance
// Call an instance method.
TestClass* tc = new TestClass ();
Console::WriteLine();
Console::WriteLine(S"Invoking an Instance method.");
Console::WriteLine(S"----------------------------");
tc->GetType()->InvokeMember (S"AddUp", static_cast<BindingFlags>(BindingFlags::Public |
BindingFlags::Instance | BindingFlags::CreateInstance),
0, tc, obj1);
// BindingFlags::CreateInstance
// Calling and creating an instance method.
Console::WriteLine();
Console::WriteLine(S"Invoking and creating an instance method.");
Console::WriteLine(S"-----------------------------------------");
tc->GetType()->InvokeMember (S"AddUp", static_cast<BindingFlags>(BindingFlags::Public |
BindingFlags::Instance | BindingFlags::CreateInstance),
0, tc, obj1);
// BindingFlags::DeclaredOnly
TestClass* tc2 = new TestClass();
Console::WriteLine();
Console::WriteLine(S"DeclaredOnly members");
Console::WriteLine(S"---------------------------------");
System::Reflection::MemberInfo* memInfo[] =
tc2->GetType()->GetMembers(BindingFlags::DeclaredOnly);
for (int i=0;i<memInfo->Length;i++) {
Console::WriteLine(memInfo[i]->Name);
}
// BindingFlags::SuppressChangeType
TestClass* obj = new TestClass();
Console::WriteLine();
Console::WriteLine(S"Invoking static method - PrintName");
Console::WriteLine(S"---------------------------------");
System::Reflection::MethodInfo* methInfo =
obj->GetType()->GetMethod(S"PrintName");
Object* args1[] = {S"Brad", S"Smith"};
methInfo->Invoke(obj, static_cast<BindingFlags>(BindingFlags::SuppressChangeType |
BindingFlags::InvokeMethod), 0, args1, 0);
// BindingFlags::IgnoreCase
Console::WriteLine();
Console::WriteLine(S"Using IgnoreCase and invoking the PrintName method.");
Console::WriteLine(S"---------------------------------------------------");
methInfo = obj->GetType()->GetMethod(S"PrintName");
Object* args2[] = {S"brad", S"smith"};
methInfo->Invoke(obj, static_cast<BindingFlags>(BindingFlags::IgnoreCase |
BindingFlags::InvokeMethod), 0, args2, 0);
// BindingFlags::IgnoreReturn
Console::WriteLine();
Console::WriteLine(S"Using IgnoreReturn and invoking the PrintName method.");
Console::WriteLine(S"-----------------------------------------------------");
methInfo = obj->GetType()->GetMethod(S"PrintName");
Object* args3[] = {S"Brad", S"Smith"};
methInfo->Invoke(obj, static_cast<BindingFlags>(BindingFlags::IgnoreReturn |
BindingFlags::InvokeMethod), 0, args3, 0);
// BindingFlags::OptionalParamBinding
Console::WriteLine();
Console::WriteLine(S"Using OptionalParamBinding and invoking the PrintName method.");
Console::WriteLine(S"-------------------------------------------------------------");
methInfo = obj->GetType()->GetMethod(S"PrintName");
Object* args4[] = {S"Brad", S"Smith"};
methInfo->Invoke(obj, static_cast<BindingFlags>(BindingFlags::OptionalParamBinding |
BindingFlags::InvokeMethod), 0, args4, 0);
// BindingFlags::ExactBinding
Console::WriteLine();
Console::WriteLine(S"Using ExactBinding and invoking the PrintName method.");
Console::WriteLine(S"-----------------------------------------------------");
methInfo = obj->GetType()->GetMethod(S"PrintName");
Object* args5[] = {S"Brad", S"Smith"};
methInfo->Invoke(obj, static_cast<BindingFlags>(BindingFlags::ExactBinding |
BindingFlags::InvokeMethod), 0, args5, 0);
// BindingFlags::FlattenHierarchy
Console::WriteLine();
Console::WriteLine(S"Using FlattenHierarchy and invoking the PrintName method.");
Console::WriteLine(S"---------------------------------------------------------");
methInfo = obj->GetType()->GetMethod(S"PrintName");
Object* args6[] = {S"Brad", S"Smith"};
methInfo->Invoke(obj, static_cast<BindingFlags>(BindingFlags::FlattenHierarchy |
BindingFlags::InvokeMethod), 0, args6, 0);
}
};
int main()
{
String* args[] = Environment::GetCommandLineArgs();
Invoke::Go();
}
//}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
名前空間: System.Reflection
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
アセンブリ: Mscorlib (Mscorlib.dll 内)