BindingFlags 列舉
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指定控件系結的旗標，以及透過反映來搜尋成員和類型的方式。
此列舉支援其成員值的位元組合。
public enum class BindingFlags[System.Flags]
public enum BindingFlags[System.Flags]
[System.Serializable]
public enum BindingFlags[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum BindingFlags[<System.Flags>]
type BindingFlags = [<System.Flags>]
[<System.Serializable>]
type BindingFlags = [<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type BindingFlags = Public Enum BindingFlags- 繼承
- 屬性
欄位
| 名稱 | 值 | Description |
|---|---|---|
| Default | 0 | 規定不定義任何約束標誌。 |
| IgnoreCase | 1 | 規定在具有約束力時不應考慮成員名稱的具體情況。 |
| DeclaredOnly | 2 | 規定僅應考慮在所提供型別階層層級宣告的成員。 繼承成員不被考慮。 |
| Instance | 4 | 指定要包含實例成員進行搜尋。 |
| Static | 8 | 指定搜尋時必須包含靜態成員。 |
| Public | 16 | 規定公眾成員必須納入搜尋範圍。 |
| NonPublic | 32 | 規定非私人會員必須納入搜尋。 |
| FlattenHierarchy | 64 | 規定公開且受保護的靜態成員，應返回階層中。 繼承類別中的私人靜態成員不會被回傳。 靜態成員包括欄位、方法、事件與屬性。 巢狀型別不會回傳。 |
| InvokeMethod | 256 | 指定要呼叫一個方法。 這不能是建構子或型別初始化器。 此旗標會傳遞給 |
| CreateInstance | 512 | 指定反射應建立指定類型的實例。 呼叫與給定參數相符的建構子。 所提供的成員名稱會被忽略。 若未指定查詢類型，（實例 |公開）將申請。 無法呼叫型別初始化器。 此旗標會傳遞給 |
| GetField | 1024 | 指定應回傳指定欄位的值。 此旗標會傳遞給 |
| SetField | 2048 | 指定應設定指定欄位的值。 此旗標會傳遞給 |
| GetProperty | 4096 | 指定應回傳指定屬性的價值。 此旗標會傳遞給 |
| SetProperty | 8192 | 指定指定屬性的值應被設定。 對於 COM 性質，指定此綁定旗標等同於指定 此旗標會傳遞給 |
| PutDispProperty | 16384 | 指定 |
| PutRefDispProperty | 32768 | 指定 |
| ExactBinding | 65536 | 規定所提供參數的型別必須與對應的形式參數型態完全相符。 如果呼叫者提供非空 |
| SuppressChangeType | 131072 | 未實作。 |
| OptionalParamBinding | 262144 | 回傳參數數量與所提供參數數量相符的成員集合。 此綁定標誌用於參數預設值及參數為變數（varargs）的方法。 此旗標僅應用於 InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])。 |
| IgnoreReturn | 16777216 | 在 COM 互操作中，用來指定成員的回傳值可以忽略。 |
| DoNotWrapExceptions | 33554432 | 規定例外不應被包裹在 TargetInvocationException。 |
範例
以下範例展示了許多具有約束力的旗幟。
using System;
using System.Reflection;
using System.IO;
namespace BindingFlagsSnippet
{
class Example
{
static void Main()
{
// 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 | BindingFlags.Public |
BindingFlags.Static, 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 with ref parameters.
Console.WriteLine();
Console.WriteLine("Invoking a method with ref parameters.");
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]);
// BindingFlags.CreateInstance
// Creating an instance with a parameterless constructor.
Console.WriteLine();
Console.WriteLine("Creating an instance with a parameterless constructor.");
Console.WriteLine("------------------------------------------------------");
object cobj = t.InvokeMember ("TestClass", BindingFlags.Public |
BindingFlags.Instance | BindingFlags.CreateInstance,
null, null, new object [] {});
Console.WriteLine("Instance of {0} created.", cobj.GetType().Name);
// Creating an instance with a constructor that has parameters.
Console.WriteLine();
Console.WriteLine("Creating an instance with a constructor that has parameters.");
Console.WriteLine("------------------------------------------------------------");
cobj = t.InvokeMember ("TestClass", BindingFlags.Public |
BindingFlags.Instance | BindingFlags.CreateInstance,
null, null, new object [] { "Hello, World!" });
Console.WriteLine("Instance of {0} created with initial value '{1}'.", cobj.GetType().Name,
cobj.GetType().InvokeMember("Name", BindingFlags.GetField, null, cobj, null));
// BindingFlags.DeclaredOnly
Console.WriteLine();
Console.WriteLine("DeclaredOnly instance members.");
Console.WriteLine("------------------------------");
System.Reflection.MemberInfo[] memInfo =
t.GetMembers(BindingFlags.DeclaredOnly | BindingFlags.Instance |
BindingFlags.Public);
for(int i=0;i<memInfo.Length;i++)
{
Console.WriteLine(memInfo[i].Name);
}
// BindingFlags.IgnoreCase
Console.WriteLine();
Console.WriteLine("Using IgnoreCase and invoking the PrintName method.");
Console.WriteLine("---------------------------------------------------");
t.InvokeMember("printname", BindingFlags.IgnoreCase | BindingFlags.Static |
BindingFlags.Public | BindingFlags.InvokeMethod, null, null, new object[]
{"Brad","Smith"});
// BindingFlags.FlattenHierarchy
Console.WriteLine();
Console.WriteLine("Using FlattenHierarchy to get inherited static protected and public members." );
Console.WriteLine("----------------------------------------------------------------------------");
FieldInfo[] finfos = typeof(MostDerived).GetFields(BindingFlags.NonPublic | BindingFlags.Public |
BindingFlags.Static | BindingFlags.FlattenHierarchy);
foreach (FieldInfo finfo in finfos)
{
Console.WriteLine("{0} defined in {1}.", finfo.Name, finfo.DeclaringType.Name);
}
Console.WriteLine();
Console.WriteLine("Without FlattenHierarchy." );
Console.WriteLine("-------------------------");
finfos = typeof(MostDerived).GetFields(BindingFlags.NonPublic | BindingFlags.Public |
BindingFlags.Static);
foreach (FieldInfo finfo in finfos)
{
Console.WriteLine("{0} defined in {1}.", finfo.Name, finfo.DeclaringType.Name);
}
}
}
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 () : this("initialName") {}
public TestClass (string initName)
{
Name = initName;
}
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);
}
}
public class Base
{
static int BaseOnlyPrivate = 0;
protected static int BaseOnly = 0;
}
public class Derived : Base
{
public static int DerivedOnly = 0;
}
public class MostDerived : Derived {}
}
/* This example produces output similar to the following:
Invoking a static method.
-------------------------
Hello
Invoking an instance method.
----------------------------
AddUp Called 1 times
AddUp Called 2 times
Invoking a method with parameters.
---------------------------------
100.09 + 184.45 = 284.54
Invoking a field (getting and setting.)
--------------------------------------
Name == initialName
Name == NewName
Invoking an indexed property (getting and setting.)
--------------------------------------------------
Item[3] == 3
Item[3] == NewValue
Getting a field or property.
----------------------------
Name == NewName
Value == the value
Invoking a method with named parameters.
---------------------------------------
Mouse,Micky
Invoking a default member of a type.
------------------------------------
12/23/2009 4:29:21 PM
Invoking a method with ref parameters.
--------------------------------------
2, 1
Creating an instance with a parameterless constructor.
------------------------------------------------------
Instance of TestClass created.
Creating an instance with a constructor that has parameters.
------------------------------------------------------------
Instance of TestClass created with initial value 'Hello, World!'.
DeclaredOnly instance members.
------------------------------
get_Item
set_Item
get_Value
AddUp
PrintTime
Swap
.ctor
.ctor
Item
Value
Name
Using IgnoreCase and invoking the PrintName method.
---------------------------------------------------
Smith,Brad
Using FlattenHierarchy to get inherited static protected and public members.
----------------------------------------------------------------------------
DerivedOnly defined in Derived.
BaseOnly defined in Base.
Without FlattenHierarchy.
-------------------------
*/
Imports System.Reflection
Imports System.IO
Class Invoke
Public Shared Sub Main()
' 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 Or BindingFlags.Public _
Or BindingFlags.Static, 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 with ByRef parameters.")
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))
' BindingFlags.CreateInstance
' Creating an instance.
Console.WriteLine()
Console.WriteLine("Creating an instance with parameterless constructor.")
Console.WriteLine("----------------------------------------------------")
Dim obj As Object = GetType(TestClass).InvokeMember("TestClass", BindingFlags.CreateInstance, _
Nothing, Nothing, New Object() {})
Console.WriteLine("Instance of {0} created.", obj.GetType().Name)
Console.WriteLine()
Console.WriteLine("Creating an instance with a constructor that has parameters.")
Console.WriteLine("------------------------------------------------------------")
obj = GetType(TestClass).InvokeMember("TestClass", BindingFlags.CreateInstance, Nothing, _
Nothing, New Object() { "Hello, World!" })
Console.WriteLine("Instance of {0} created with initial value '{1}'.", obj.GetType().Name, _
obj.GetType().InvokeMember("Name", BindingFlags.GetField, Nothing, obj, Nothing))
' BindingFlags.DeclaredOnly
Console.WriteLine()
Console.WriteLine("DeclaredOnly instance members.")
Console.WriteLine("------------------------------")
Dim memInfo As System.Reflection.MemberInfo() = t.GetMembers(BindingFlags.DeclaredOnly Or _
BindingFlags.Public Or BindingFlags.Instance)
Dim i As Integer
For i = 0 To memInfo.Length - 1
Console.WriteLine(memInfo(i).Name)
Next i
' BindingFlags.IgnoreCase
Console.WriteLine()
Console.WriteLine("Using IgnoreCase and invoking the PrintName method.")
Console.WriteLine("---------------------------------------------------")
t.InvokeMember("printname", BindingFlags.IgnoreCase Or BindingFlags.Public Or _
BindingFlags.Static Or BindingFlags.InvokeMethod, Nothing, Nothing, _
New Object() {"Brad", "Smith"})
' BindingFlags.FlattenHierarchy
Console.WriteLine()
Console.WriteLine("Using FlattenHierarchy to get inherited static protected and public members." )
Console.WriteLine("----------------------------------------------------------------------------")
Dim finfos() As FieldInfo = GetType(MostDerived).GetFields(BindingFlags.NonPublic Or _
BindingFlags.Public Or BindingFlags.Static Or BindingFlags.FlattenHierarchy)
For Each finfo As FieldInfo In finfos
Console.WriteLine("{0} defined in {1}.", finfo.Name, finfo.DeclaringType.Name)
Next
Console.WriteLine()
Console.WriteLine("Without FlattenHierarchy." )
Console.WriteLine("-------------------------")
finfos = GetType(MostDerived).GetFields(BindingFlags.NonPublic Or BindingFlags.Public Or _
BindingFlags.Static)
For Each finfo As FieldInfo In finfos
Console.WriteLine("{0} defined in {1}.", finfo.Name, finfo.DeclaringType.Name)
Next
End Sub
End Class
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(ByVal initName As String)
Name = initName
End Sub
Public Sub New()
MyClass.New("initialName")
End Sub
Private methodCalled As Integer = 0
Public Shared Sub SayHello()
Console.WriteLine("Hello")
End Sub
Public Sub AddUp()
methodCalled += 1
Console.WriteLine("AddUp Called {0} times", methodCalled)
End Sub
Public Shared Function ComputeSum(ByVal d1 As Double, ByVal d2 As Double) As Double
Return d1 + d2
End Function
Public Shared Sub PrintName(ByVal firstName As [String], ByVal lastName As [String])
Console.WriteLine("{0},{1}", lastName, firstName)
End Sub
Public Sub PrintTime()
Console.WriteLine(DateTime.Now)
End Sub
Public Sub Swap(ByRef a As Integer, ByRef b As Integer)
Dim x As Integer = a
a = b
b = x
End Sub
End Class
<DefaultMemberAttribute("PrintTime")> _
Public Class TestClass2
Public Sub PrintTime()
Console.WriteLine(DateTime.Now)
End Sub
End Class
Public Class Base
Shared BaseOnlyPrivate As Integer = 0
Protected Shared BaseOnly As Integer = 0
End Class
Public Class Derived
Inherits Base
Public Shared DerivedOnly As Integer = 0
End Class
Public Class MostDerived
Inherits Derived
End Class
' This example produces output similar to the following:
'
'Invoking a static method.
'-------------------------
'Hello
'
'Invoking an instance method.
'----------------------------
'AddUp Called 1 times
'AddUp Called 2 times
'
'Invoking a method with parameters.
'---------------------------------
'100.09 + 184.45 = 284.54
'
'Invoking a field (getting and setting.)
'--------------------------------------
'Name == initialName
'Name == NewName
'
'Invoking an indexed property (getting and setting.)
'--------------------------------------------------
'Item[3] == 3
'Item[3] == NewValue
'
'Getting a field or property.
'----------------------------
'Name == NewName
'Value == the value
'
'Invoking a method with named parameters.
'---------------------------------------
'Mouse,Micky
'
'Invoking a default member of a type.
'------------------------------------
'12/23/2009 4:34:22 PM
'
'Invoking a method with ByRef parameters.
'----------------------------------------
'2, 1
'
'Creating an instance with parameterless constructor.
'----------------------------------------------------
'Instance of TestClass created.
'
'Creating an instance with a constructor that has parameters.
'------------------------------------------------------------
'Instance of TestClass created with initial value 'Hello, World!'.
'
'DeclaredOnly instance members.
'------------------------------
'get_Item
'set_Item
'get_Value
'AddUp
'PrintTime
'Swap
'.ctor
'.ctor
'Item
'Value
'Name
'
'Using IgnoreCase and invoking the PrintName method.
'---------------------------------------------------
'Smith,Brad
'
'Using FlattenHierarchy to get inherited static protected and public members.
'----------------------------------------------------------------------------
'DerivedOnly defined in Derived.
'BaseOnly defined in Base.
'
'Without FlattenHierarchy.
'-------------------------
'
備註
這些 控制 BindingFlags 、 System.Reflection中許多類別System的綁定，以及System.Runtime用於呼叫、建立、取得、設定及尋找成員與型態的命名空間。
BindingFlags 用於以下 Type 方法及其他場所，例如 MethodBase.Invoke：
InvokeMember 尤其 GetMethod 重要。
綁定旗標可依其識別型別成員的方式分類，如下表所示。
| 以無障礙性識別 | 以具約束力論證識別 | 依操作識別 |
|---|---|---|
| 僅宣告 扁平化階層 IgnoreCase 忽略返回 Instance 非公立 公共 靜態的 |
精確綁定 可選參數綁定 |
創建實例 GetField SetField GetProperty SetProperty InvokeMethod PutDispProperty PutRefDispProperty |
Note
您必須指定Instance，或Static與PublicNonPublic或一同，否則不會被退回任何成員。
下表列出了預設 Binder.ChangeType所執行的強制行為。 此表特別 BindingFlags.ExactBinding 適用於綁定旗。 一般原則是，應該 ChangeType 只執行擴寬的強制，且這些強制力永遠不會遺失資料。 擴寬強制的一個例子是將一個 32 位元有符號整數的值強制到一個 64 位元有號整數值。 這與狹窄強制不同，後者可能會遺失資料。 窄位強制的一個例子是將一個 64 位元的有號整數強制到一個 32 位元的有號整數。
| 來源類型 | 目標類型 |
|---|---|
| 任何類型 | 它的基礎類型。 |
| 任何類型 | 它實作的介面。 |
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 |
| 非參考書 | 參考。 |
當使用綁定標誌時 BindingFlags.ExactBinding ，反射模擬了共用型別系統的可及性規則。 例如，若呼叫者在同一個集合體中，呼叫者不需要對內部成員有特殊權限。 否則，呼叫者需要 ReflectionPermission。 這與受保護、私密等成員的查詢方式一致。