Type.GetField 方法

定義

命名空間:

System

組件:

System.Runtime.dll

取得目前 Type 的特定欄位。

多載

GetField(String)	搜尋具有指定名稱的公用欄位。
GetField(String, BindingFlags)	使用指定的繫結條件約束搜尋指定的欄位。

GetField(String)

來源:

Type.cs

搜尋具有指定名稱的公用欄位。

C#

public System.Reflection.FieldInfo? GetField (string name);

參數

name

String

字串，包含要取得的資料欄位的名稱。

傳回

FieldInfo

物件，代表具有指定之名稱的公用欄位 (如有找到)；否則為 null。

例外狀況

ArgumentNullException

name 為 null。

NotSupportedException

這個 Type 物件是 TypeBuilder，尚未呼叫其 CreateType() 方法。

範例

下列範例會 Type 取得指定類別的 物件、取得 FieldInfo 欄位的 物件，並顯示欄位的值。

C#

using System;
using System.Reflection;

public class MyFieldClassA
{
    public string Field = "A Field";
}

public class MyFieldClassB
{
    private string field = "B Field";
    public string Field
    {
        get
        {
            return field;
        }
        set
        {
            if (field!=value)
            {
                field=value;
            }
        }
    }
}

public class MyFieldInfoClass
{
    public static void Main()
    {
        MyFieldClassB myFieldObjectB = new MyFieldClassB();
        MyFieldClassA myFieldObjectA = new MyFieldClassA();

        Type myTypeA = typeof(MyFieldClassA);
        FieldInfo myFieldInfo = myTypeA.GetField("Field");

        Type myTypeB = typeof(MyFieldClassB);
        FieldInfo myFieldInfo1 = myTypeB.GetField("field",
            BindingFlags.NonPublic | BindingFlags.Instance);

        Console.WriteLine("The value of the public field is: '{0}'",
            myFieldInfo.GetValue(myFieldObjectA));
        Console.WriteLine("The value of the private field is: '{0}'",
            myFieldInfo1.GetValue(myFieldObjectB));
    }
}

備註

搜尋 name 會區分大小寫。 搜尋包含公用靜態和公用實例欄位。

如果目前的 Type 代表建構的泛型型別，這個方法會傳回 FieldInfo ，並將 型別參數取代為適當的型別引數。

如果目前的 Type 代表泛型型別或泛型方法定義中的型別參數，這個方法會搜尋類別條件約束的欄位。

另請參閱

• FieldInfo
• String
• DefaultBinder
• GetFields()

GetField(String, BindingFlags)

來源:

Type.cs

使用指定的繫結條件約束搜尋指定的欄位。

C#

public abstract System.Reflection.FieldInfo? GetField (string name, System.Reflection.BindingFlags bindingAttr);

參數

name

String

字串，包含要取得的資料欄位的名稱。

bindingAttr

BindingFlags

列舉值的位元組合，用來指定搜尋的執行方式。

-或-

要傳回 null 的 Default。

傳回

FieldInfo

代表符合指定之需求欄位的物件 (如有找到) ，否則為 null。

實作

GetField(String, BindingFlags)

例外狀況

ArgumentNullException

name 為 null。

範例

下列範例會取得 Type 指定類別的 物件、取得 FieldInfo 符合指定系結旗標之欄位的物件，並顯示欄位的值。

C#

using System;
using System.Reflection;

public class MyFieldClassA
{
    public string Field = "A Field";
}

public class MyFieldClassB
{
    private string field = "B Field";
    public string Field
    {
        get
        {
            return field;
        }
        set
        {
            if (field!=value)
            {
                field=value;
            }
        }
    }
}

public class MyFieldInfoClass
{
    public static void Main()
    {
        MyFieldClassB myFieldObjectB = new MyFieldClassB();
        MyFieldClassA myFieldObjectA = new MyFieldClassA();

        Type myTypeA = typeof(MyFieldClassA);
        FieldInfo myFieldInfo = myTypeA.GetField("Field");

        Type myTypeB = typeof(MyFieldClassB);
        FieldInfo myFieldInfo1 = myTypeB.GetField("field",
            BindingFlags.NonPublic | BindingFlags.Instance);

        Console.WriteLine("The value of the public field is: '{0}'",
            myFieldInfo.GetValue(myFieldObjectA));
        Console.WriteLine("The value of the private field is: '{0}'",
            myFieldInfo1.GetValue(myFieldObjectB));
    }
}

備註

下表顯示當反映類型時，方法會 Get 傳回的基類成員。

成員類型	Static	非靜態
建構函式	否	否
欄位	否	可以。 欄位一律會依名稱與簽章隱藏。
事件	不適用	常見的型別系統規則是繼承與實作 屬性的方法相同。 反映會將屬性視為 hide-by-name-and-signature。 請參閱下面的附注 2。
方法	否	可以。 (虛擬和非虛擬) 的方法可以是依名稱隱藏或依名稱隱藏和簽章。
巢狀類型	否	否
屬性	不適用	常見的型別系統規則是繼承與實作 屬性的方法相同。 反映會將屬性視為 hide-by-name-and-signature。 請參閱下面的附注 2。

1. 依名稱與簽章隱藏會考慮簽章的所有部分，包括自訂修飾詞、傳回類型、參數類型、sentinels 和 Unmanaged 呼叫慣例。 這是二進位比較。

2. 針對反映，屬性和事件會依名稱與簽章隱藏。 如果您的屬性同時具有基類中的 get 和 set 存取子，但衍生類別只有 get 存取子，衍生類別屬性會隱藏基類屬性，而且您將無法在基類上存取 setter。

3. 自訂屬性不是一般型別系統的一部分。

下列 BindingFlags 篩選旗標可用來定義要包含在搜尋中的欄位：

• 您必須指定 BindingFlags.Instance 或 BindingFlags.Static ，才能取得傳回。

• 指定 BindingFlags.Public 以在搜尋中包含公用欄位。

• 指定 BindingFlags.NonPublic 以在搜尋中包含非公用欄位 (，也就是私人、內部及受保護的) 欄位。

• 指定要 BindingFlags.FlattenHierarchy 在 public 階層中包含和 protected 靜態成員; private 繼承類別中的靜態成員不包含在內。

下列 BindingFlags 修飾詞旗標可用來變更搜尋的運作方式：

• BindingFlags.IgnoreCase 忽略 的大小 name 寫。

• BindingFlags.DeclaredOnly 只搜尋 在 上宣告的 Type 欄位，而不是只繼承的欄位。

如需相關資訊，請參閱 System.Reflection.BindingFlags 。

如果目前的 Type 代表建構的泛型型別，這個方法會傳回 FieldInfo ，並將 型別參數取代為適當的型別引數。

如果目前的 Type 代表泛型型別或泛型方法定義中的型別參數，這個方法會搜尋類別條件約束的欄位。

另請參閱

• FieldInfo
• String
• BindingFlags
• DefaultBinder
• GetFields()