Type.GetField 메서드

정의

현재 Type의 특정 필드를 가져옵니다.Gets a specific field of the current Type.

오버로드

GetField(String)

지정된 이름의 public 필드를 검색합니다.Searches for the public field with the specified name.

GetField(String, BindingFlags)

지정된 필드를 지정된 바인딩 제약 조건으로 검색합니다.Searches for the specified field, using the specified binding constraints.

GetField(String)

지정된 이름의 public 필드를 검색합니다.Searches for the public field with the specified name.

public:
 virtual System::Reflection::FieldInfo ^ GetField(System::String ^ name);
public System.Reflection.FieldInfo GetField (string name);
abstract member GetField : string -> System.Reflection.FieldInfo
override this.GetField : string -> System.Reflection.FieldInfo
Public Function GetField (name As String) As FieldInfo

매개 변수

name
String

가져올 데이터 필드의 이름이 포함된 문자열입니다.The string containing the name of the data field to get.

반환

지정된 이름의 public 필드를 나타내는 개체이며(있는 경우), 이러한 개체가 없으면 null을 반환합니다.An object representing the public field with the specified name, if found; otherwise, null.

구현

예외

namenull입니다.name is null.

Type 개체는 해당 TypeBuilder 메서드가 아직 호출되지 않은 CreateType()입니다.This Type object is a TypeBuilder whose CreateType() method has not yet been called.

예제

다음 예제에서는 지정 된 클래스에 대 한 Type 개체를 가져오고, 필드에 대 한 FieldInfo 개체를 가져오고, 필드의 값을 표시 합니다.The following example gets the Type object for the specified class, obtains the FieldInfo object for the field, and displays the value of the field.

using namespace System;
using namespace System::Reflection;
using namespace System::Security;
public ref class MyFieldClassA
{
public:
   String^ field;
   MyFieldClassA()
   {
      field = "A Field";
   }


   property String^ Field 
   {
      String^ get()
      {
         return field;
      }

      void set( String^ value )
      {
         if ( field != value )
         {
            field = value;
         }
      }

   }

};

public ref class MyFieldClassB
{
public:
   String^ field;
   MyFieldClassB()
   {
      field = "B Field";
   }


   property String^ Field 
   {
      String^ get()
      {
         return field;
      }

      void set( String^ value )
      {
         if ( field != value )
         {
            field = value;
         }
      }

   }

};

int main()
{
   try
   {
      MyFieldClassB^ myFieldObjectB = gcnew MyFieldClassB;
      MyFieldClassA^ myFieldObjectA = gcnew MyFieldClassA;
      Type^ myTypeA = Type::GetType( "MyFieldClassA" );
      FieldInfo^ myFieldInfo = myTypeA->GetField( "field" );
      Type^ myTypeB = Type::GetType( "MyFieldClassB" );
      FieldInfo^ myFieldInfo1 = myTypeB->GetField( "field", static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance) );
      Console::WriteLine( "The value of the field is : {0} ", myFieldInfo->GetValue( myFieldObjectA ) );
      Console::WriteLine( "The value of the field is : {0} ", myFieldInfo1->GetValue( myFieldObjectB ) );
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "Exception Raised!" );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "Exception Raised!" );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception Raised!" );
      Console::WriteLine( "Message : {0}", e->Message );
   }

}


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));
    }
}

Imports System.Reflection

Public Class MyFieldClassA
    Public Field As String = "A Field"
End Class

Public Class MyFieldClassB
    Private myField As String = "B Field"

    Public Property Field() As String
        Get
            Return myField
        End Get
        Set(ByVal Value As String)
            If myField <> value Then
                myField = value
            End If
        End Set
    End Property
End Class


Public Class MyFieldInfoClass

    Public Shared Sub Main()
        Dim myFieldObjectB As New MyFieldClassB()
        Dim myFieldObjectA As New MyFieldClassA()

        Dim myTypeA As Type = GetType(MyFieldClassA)
        Dim myFieldInfo As FieldInfo = myTypeA.GetField("Field")

        Dim myTypeB As Type = GetType(MyFieldClassB)
        Dim myFieldInfo1 As FieldInfo = myTypeB.GetField("myField", _
            BindingFlags.NonPublic Or 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))
    End Sub

End Class

설명

name 검색은 대/소문자를 구분 합니다.The search for name is case-sensitive. 검색에는 public static 및 public 인스턴스 필드가 포함 됩니다.The search includes public static and public instance fields.

현재 Type가 생성 된 제네릭 형식을 나타내는 경우이 메서드는 형식 매개 변수를 적절 한 형식 인수로 대체 하 여 FieldInfo을 반환 합니다.If the current Type represents a constructed generic type, this method returns the FieldInfo with the type parameters replaced by the appropriate type arguments.

현재 Type가 제네릭 형식 또는 제네릭 메서드 정의의 형식 매개 변수를 나타내는 경우이 메서드는 클래스 제약 조건의 필드를 검색 합니다.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the fields of the class constraint.

추가 정보

GetField(String, BindingFlags)

지정된 필드를 지정된 바인딩 제약 조건으로 검색합니다.Searches for the specified field, using the specified binding constraints.

public:
 abstract System::Reflection::FieldInfo ^ GetField(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
public abstract System.Reflection.FieldInfo GetField (string name, System.Reflection.BindingFlags bindingAttr);
abstract member GetField : string * System.Reflection.BindingFlags -> System.Reflection.FieldInfo
Public MustOverride Function GetField (name As String, bindingAttr As BindingFlags) As FieldInfo

매개 변수

name
String

가져올 데이터 필드의 이름이 포함된 문자열입니다.The string containing the name of the data field to get.

bindingAttr
BindingFlags

검색 방법을 지정하는 열거형 값의 비트 조합입니다.A bitwise combination of the enumeration values that specify how the search is conducted.

또는-or- Default을 반환하는 null입니다.Default to return null.

반환

지정된 요구 사항과 일치하는 필드를 나타내는 개체이며(있는 경우), 이러한 개체가 없으면 null을 반환합니다.An object representing the field that matches the specified requirements, if found; otherwise, null.

구현

예외

namenull입니다.name is null.

예제

다음 예제에서는 지정 된 클래스에 대 한 Type 개체를 가져오고, 지정 된 바인딩 플래그와 일치 하는 필드에 대 한 FieldInfo 개체를 가져오고, 필드의 값을 표시 합니다.The following example gets the Type object for the specified class, obtains the FieldInfo object for the field that matches the specified binding flags, and displays the value of the field.

using namespace System;
using namespace System::Reflection;
using namespace System::Security;
public ref class MyFieldClassA
{
public:
   String^ field;
   MyFieldClassA()
   {
      field = "A Field";
   }


   property String^ Field 
   {
      String^ get()
      {
         return field;
      }

      void set( String^ value )
      {
         if ( field != value )
         {
            field = value;
         }
      }

   }

};

public ref class MyFieldClassB
{
public:
   String^ field;
   MyFieldClassB()
   {
      field = "B Field";
   }


   property String^ Field 
   {
      String^ get()
      {
         return field;
      }

      void set( String^ value )
      {
         if ( field != value )
         {
            field = value;
         }
      }

   }

};

int main()
{
   try
   {
      MyFieldClassB^ myFieldObjectB = gcnew MyFieldClassB;
      MyFieldClassA^ myFieldObjectA = gcnew MyFieldClassA;
      Type^ myTypeA = Type::GetType( "MyFieldClassA" );
      FieldInfo^ myFieldInfo = myTypeA->GetField( "field" );
      Type^ myTypeB = Type::GetType( "MyFieldClassB" );
      FieldInfo^ myFieldInfo1 = myTypeB->GetField( "field", static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance) );
      Console::WriteLine( "The value of the field is : {0} ", myFieldInfo->GetValue( myFieldObjectA ) );
      Console::WriteLine( "The value of the field is : {0} ", myFieldInfo1->GetValue( myFieldObjectB ) );
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "Exception Raised!" );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "Exception Raised!" );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception Raised!" );
      Console::WriteLine( "Message : {0}", e->Message );
   }

}


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));
    }
}

Imports System.Reflection

Public Class MyFieldClassA
    Public Field As String = "A Field"
End Class

Public Class MyFieldClassB
    Private myField As String = "B Field"

    Public Property Field() As String
        Get
            Return myField
        End Get
        Set(ByVal Value As String)
            If myField <> value Then
                myField = value
            End If
        End Set
    End Property
End Class


Public Class MyFieldInfoClass

    Public Shared Sub Main()
        Dim myFieldObjectB As New MyFieldClassB()
        Dim myFieldObjectA As New MyFieldClassA()

        Dim myTypeA As Type = GetType(MyFieldClassA)
        Dim myFieldInfo As FieldInfo = myTypeA.GetField("Field")

        Dim myTypeB As Type = GetType(MyFieldClassB)
        Dim myFieldInfo1 As FieldInfo = myTypeB.GetField("myField", _
            BindingFlags.NonPublic Or 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))
    End Sub

End Class

설명

다음 표에서는 형식에 대해 리플렉션할 때 Get 메서드에서 반환 되는 기본 클래스의 멤버를 보여 줍니다.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

멤버 유형Member Type 정적Static Static이 아니고Non-Static
생성자Constructor No No
필드Field No 예.Yes. 필드는 항상 이름 및 서명에서 숨겨집니다.A field is always hide-by-name-and-signature.
행사Event 해당 없음Not applicable 공용 형식 시스템 규칙의 상속 속성을 구현 하는 메서드의 것과 동일 된다는 것입니다.The common type system rule is that the inheritance is the same as that of the methods that implement the property. 리플렉션 속성 이름 및 서명으로 숨기기 취급 됩니다.Reflection treats properties as hide-by-name-and-signature. 참고 2 아래를 참조 하세요.See note 2 below.
방법Method No 예.Yes. (가상 및 비가상) 메서드 이름에서 숨김 또는 이름 및 서명으로 숨기기 수 있습니다.A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
중첩된 형식Nested Type No No
속성Property 해당 없음Not applicable 공용 형식 시스템 규칙의 상속 속성을 구현 하는 메서드의 것과 동일 된다는 것입니다.The common type system rule is that the inheritance is the same as that of the methods that implement the property. 리플렉션 속성 이름 및 서명으로 숨기기 취급 됩니다.Reflection treats properties as hide-by-name-and-signature. 참고 2 아래를 참조 하세요.See note 2 below.
  1. 이름 및 서명으로 숨기기 모든 사용자 지정 한정자를 포함 하 여 서명의 부분 반환 형식, 매개 변수 형식, 센티널, 및 관리 되지 않는 호출 규칙을 고려 합니다.Hide-by-name-and-signature considers all of the parts of the signature, including custom modifiers, return types, parameter types, sentinels, and unmanaged calling conventions. 이것은 이진 비교 합니다.This is a binary comparison.

  2. 리플렉션, 속성 및 이벤트는 이름 및 서명에서 숨겨집니다.For reflection, properties and events are hide-by-name-and-signature. 기본 클래스에서 get 및 set 접근자 모두를 사용 하 여 속성을 갖지만 파생된 클래스에 get 접근자만 하는 경우 파생된 클래스 속성을 기본 클래스 속성 숨기고 기본 클래스의 setter를 액세스할 수 없습니다.If you have a property with both a get and a set accessor in the base class, but the derived class has only a get accessor, the derived class property hides the base class property, and you will not be able to access the setter on the base class.

  3. 사용자 지정 특성의 일부분이 아닌 공용 형식 시스템입니다.Custom attributes are not part of the common type system.

다음 BindingFlags 필터 플래그를 사용 하 여 검색에 포함할 필드를 정의할 수 있습니다.The following BindingFlags filter flags can be used to define which fields to include in the search:

  • 반환을 얻으려면 BindingFlags.Instance 또는 BindingFlags.Static 중 하나를 지정 해야 합니다.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • 검색에 공용 필드를 포함 하려면 BindingFlags.Public를 지정 합니다.Specify BindingFlags.Public to include public fields in the search.

  • 검색에 public이 아닌 필드 (즉, private, internal 및 protected 필드)를 포함 하려면 BindingFlags.NonPublic를 지정 합니다.Specify BindingFlags.NonPublic to include non-public fields (that is, private, internal, and protected fields) in the search.

  • 계층 구조에서 publicprotected 정적 멤버를 포함 하도록 BindingFlags.FlattenHierarchy를 지정 합니다. 상속 된 클래스의 정적 멤버 private 포함 되지 않습니다.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

다음 BindingFlags 한정자 플래그를 사용 하 여 검색의 작동 방식을 변경할 수 있습니다.The following BindingFlags modifier flags can be used to change how the search works:

  • name의 대/소문자를 무시 하려면 BindingFlags.IgnoreCase 합니다.BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnly는 단순히 상속 된 필드가 아닌 Type에 선언 된 필드만 검색 합니다.BindingFlags.DeclaredOnly to search only the fields declared on the Type, not fields that were simply inherited.

자세한 내용은 System.Reflection.BindingFlags을 참조하세요.See System.Reflection.BindingFlags for more information.

현재 Type가 생성 된 제네릭 형식을 나타내는 경우이 메서드는 형식 매개 변수를 적절 한 형식 인수로 대체 하 여 FieldInfo을 반환 합니다.If the current Type represents a constructed generic type, this method returns the FieldInfo with the type parameters replaced by the appropriate type arguments.

현재 Type가 제네릭 형식 또는 제네릭 메서드 정의의 형식 매개 변수를 나타내는 경우이 메서드는 클래스 제약 조건의 필드를 검색 합니다.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the fields of the class constraint.

추가 정보

적용 대상