Type.GetFields 메서드

정의

현재 Type의 필드를 가져옵니다.Gets the fields of the current Type.

오버로드

GetFields()

현재 Type의 모든 public 필드를 반환합니다.Returns all the public fields of the current Type.

GetFields(BindingFlags)

파생 클래스에서 재정의되면, 현재 Type에 대해 정의된 필드를 지정된 바인딩 제약 조건으로 검색합니다.When overridden in a derived class, searches for the fields defined for the current Type, using the specified binding constraints.

GetFields()

현재 Type의 모든 public 필드를 반환합니다.Returns all the public fields of the current Type.

public:
 cli::array <System::Reflection::FieldInfo ^> ^ GetFields();
public:
 virtual cli::array <System::Reflection::FieldInfo ^> ^ GetFields();
public System.Reflection.FieldInfo[] GetFields ();
member this.GetFields : unit -> System.Reflection.FieldInfo[]
abstract member GetFields : unit -> System.Reflection.FieldInfo[]
override this.GetFields : unit -> System.Reflection.FieldInfo[]
Public Function GetFields () As FieldInfo()

반환

FieldInfo[]

현재 FieldInfo에 대해 정의된 모든 public 필드를 나타내는 Type 개체의 배열입니다.An array of FieldInfo objects representing all the public fields defined for the current Type.

또는-or- 현재 FieldInfo에 대해 정의된 public 필드가 없는 경우 Type 형식의 빈 배열입니다.An empty array of type FieldInfo, if no public fields are defined for the current Type.

구현

예제

다음 예제에서는 메서드를 사용 하는 방법을 보여 줍니다 GetFields() .The following example shows a use of the GetFields() method.

#using <system.dll>

using namespace System;
using namespace System::Reflection;
using namespace System::ComponentModel::Design;

int main()
{
   try
   {
      // Get the type handle of a specified class.
      Type^ myType = ViewTechnology::typeid;

      // Get the fields of the specified class.
      array<FieldInfo^>^myField = myType->GetFields();
      Console::WriteLine( "\nDisplaying fields that have SpecialName attributes:\n" );
      for ( int i = 0; i < myField->Length; i++ )
      {
         // Determine whether or not each field is a special name.
         if ( myField[ i ]->IsSpecialName )
         {
            Console::WriteLine( "The field {0} has a SpecialName attribute.", myField[ i ]->Name );
         }
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception : {0} ", e->Message );
   }
}
using System;
using System.Reflection;
using System.ComponentModel.Design;

class FieldInfo_IsSpecialName
{
    public static void Main()
    {
        try
        {
            // Get the type handle of a specified class.
            Type myType = typeof(ViewTechnology);

            // Get the fields of the specified class.
            FieldInfo[] myField = myType.GetFields();

            Console.WriteLine("\nDisplaying fields that have SpecialName attributes:\n");
            for(int i = 0; i < myField.Length; i++)
            {
                // Determine whether or not each field is a special name.
                if(myField[i].IsSpecialName)
                {
                    Console.WriteLine("The field {0} has a SpecialName attribute.",
                        myField[i].Name);
                }
            }
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception : {0} " , e.Message);
        }
    }
}
Imports System.Reflection
Imports System.ComponentModel.Design

Class FieldInfo_IsSpecialName

    Public Shared Sub Main()
        Try
            ' Get the type handle of a specified class.
            Dim myType As Type = GetType(ViewTechnology)

            ' Get the fields of a specified class.
            Dim myField As FieldInfo() = myType.GetFields()

            Console.WriteLine(ControlChars.Cr + "Displaying fields that have SpecialName attributes:" + ControlChars.Cr)
            Dim i As Integer
            For i = 0 To myField.Length - 1
                ' Determine whether or not each field is a special name.
                If myField(i).IsSpecialName Then
                    Console.WriteLine("The field {0} has a SpecialName attribute.", myField(i).Name)
                End If
            Next i
        Catch e As Exception
            Console.WriteLine("Exception : {0} ", e.Message.ToString())
        End Try
    End Sub
End Class

설명

GetFields메서드는 사전순 또는 선언 순서와 같은 특정 순서로 필드를 반환 하지 않습니다.The GetFields method does not return fields in a particular order, such as alphabetical or declaration order. 코드가 반환 되는 순서에 따라 달라 지는 것은 아닙니다.Your code must not depend on the order in which fields are returned, because that order varies.

다음 표에서는 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 비정적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.

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

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

추가 정보

적용 대상

GetFields(BindingFlags)

파생 클래스에서 재정의되면, 현재 Type에 대해 정의된 필드를 지정된 바인딩 제약 조건으로 검색합니다.When overridden in a derived class, searches for the fields defined for the current Type, using the specified binding constraints.

public:
 abstract cli::array <System::Reflection::FieldInfo ^> ^ GetFields(System::Reflection::BindingFlags bindingAttr);
public abstract System.Reflection.FieldInfo[] GetFields (System.Reflection.BindingFlags bindingAttr);
abstract member GetFields : System.Reflection.BindingFlags -> System.Reflection.FieldInfo[]
Public MustOverride Function GetFields (bindingAttr As BindingFlags) As FieldInfo()

매개 변수

bindingAttr
BindingFlags

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

또는-or-

빈 배열을 반환하는 Default입니다.Default to return an empty array.

반환

FieldInfo[]

현재 FieldInfo에 대해 정의된 필드 중 지정된 바인딩 제약 조건과 일치하는 모든 필드를 나타내는 Type 개체의 배열입니다.An array of FieldInfo objects representing all fields defined for the current Type that match the specified binding constraints.

또는-or- 현재 FieldInfo에 대해 정의된 필드가 없거나 정의된 필드 중 해당 바인딩 제약 조건과 일치하는 필드가 없을 경우 Type 형식의 빈 배열입니다.An empty array of type FieldInfo, if no fields are defined for the current Type, or if none of the defined fields match the binding constraints.

구현

예제

다음 예제에서는 메서드를 사용 하는 방법을 보여 줍니다 GetFields(BindingFlags) .The following example shows a use of the GetFields(BindingFlags) method.

using namespace System;
using namespace System::Reflection;
using namespace System::Runtime::InteropServices;
public ref class AttributesSample
{
public:
   void Mymethod( int int1m, [Out]interior_ptr<String^> str2m, interior_ptr<String^> str3m )
   {
       *str2m = "in Mymethod";
   }
};

void PrintAttributes( Type^ attribType, int iAttribValue )
{
   if (  !attribType->IsEnum )
   {
      Console::WriteLine( "This type is not an enum." );
      return;
   }

   array<FieldInfo^>^fields = attribType->GetFields( static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Static) );
   for ( int i = 0; i < fields->Length; i++ )
   {
      int fieldvalue = safe_cast<Int32>(fields[ i ]->GetValue( nullptr ));
      if ( (fieldvalue & iAttribValue) == fieldvalue )
      {
         Console::WriteLine( fields[ i ]->Name );
      }
   }
}

int main()
{
   Console::WriteLine( "Reflection.MethodBase.Attributes Sample" );

   // Get the type.
   Type^ MyType = Type::GetType( "AttributesSample" );

   // Get the method Mymethod on the type.
   MethodBase^ Mymethodbase = MyType->GetMethod( "Mymethod" );

   // Display the method name.
   Console::WriteLine( "Mymethodbase = {0}", Mymethodbase );

   // Get the MethodAttribute enumerated value.
   MethodAttributes Myattributes = Mymethodbase->Attributes;

   // Display the flags that are set.
   PrintAttributes( System::Reflection::MethodAttributes::typeid, (int)Myattributes );
   return 0;
}

using System;
using System.Reflection;

class AttributesSample
{
    public void Mymethod (int int1m, out string str2m, ref string str3m)
    {
        str2m = "in Mymethod";
    }

    public static int Main(string[] args)
    {
        Console.WriteLine ("Reflection.MethodBase.Attributes Sample");

        // Get the type.
        Type MyType = Type.GetType("AttributesSample");

        // Get the method Mymethod on the type.
        MethodBase Mymethodbase = MyType.GetMethod("Mymethod");

        // Display the method name.
        Console.WriteLine("Mymethodbase = " + Mymethodbase);

        // Get the MethodAttribute enumerated value.
        MethodAttributes Myattributes = Mymethodbase.Attributes;

        // Display the flags that are set.
        PrintAttributes(typeof(System.Reflection.MethodAttributes), (int) Myattributes);
        return 0;
    }

    public static void PrintAttributes(Type attribType, int iAttribValue)
    {
        if (!attribType.IsEnum)
        {
            Console.WriteLine("This type is not an enum.");
            return;
        }

        FieldInfo[] fields = attribType.GetFields(BindingFlags.Public | BindingFlags.Static);
        for (int i = 0; i < fields.Length; i++)
        {
            int fieldvalue = (Int32)fields[i].GetValue(null);
            if ((fieldvalue & iAttribValue) == fieldvalue)
            {
                Console.WriteLine(fields[i].Name);
            }
        }
    }
}
Imports System.Reflection

Class AttributesSample

    Public Sub Mymethod(ByVal int1m As Integer, ByRef str2m As String, ByRef str3m As String)
        str2m = "in Mymethod"
    End Sub

    Public Shared Function Main(ByVal args() As String) As Integer
        Console.WriteLine("Reflection.MethodBase.Attributes Sample")

        ' Get the type.
        Dim MyType As Type = Type.GetType("AttributesSample")

        ' Get the method Mymethod on the type.
        Dim Mymethodbase As MethodBase = MyType.GetMethod("Mymethod")

        ' Display the method name.
        Console.WriteLine("Mymethodbase = {0}.", Mymethodbase)

        ' Get the MethodAttribute enumerated value.
        Dim Myattributes As MethodAttributes = Mymethodbase.Attributes

        ' Display the flags that are set.
        PrintAttributes(GetType(System.Reflection.MethodAttributes), CInt(Myattributes))
        Return 0
    End Function 'Main

    Public Shared Sub PrintAttributes(ByVal attribType As Type, ByVal iAttribValue As Integer)
        If Not attribType.IsEnum Then
            Console.WriteLine("This type is not an enum.")
            Return
        End If
        Dim fields As FieldInfo() = attribType.GetFields((BindingFlags.Public Or BindingFlags.Static))
        Dim i As Integer
        For i = 0 To fields.Length - 1
            Dim fieldvalue As Integer = CType(fields(i).GetValue(Nothing), Int32)
            If (fieldvalue And iAttribValue) = fieldvalue Then
                Console.WriteLine(fields(i).Name)
            End If
        Next i
    End Sub
End Class

설명

GetFields(BindingFlags)오버 로드가 속성 정보를 성공적으로 검색 하려면 인수에 및 중 적어도 bindingAttr 하나 이상이 포함 되어야 합니다 BindingFlags.Instance BindingFlags.Static BindingFlags.NonPublic BindingFlags.Public .For the GetFields(BindingFlags) overload to successfully retrieve property information, the bindingAttr argument must include at least one of BindingFlags.Instance and BindingFlags.Static, along with at least one of BindingFlags.NonPublic and BindingFlags.Public.

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

  • BindingFlags.Instance인스턴스 메서드를 포함 하도록 지정 합니다.Specify BindingFlags.Instance to include instance methods.

  • BindingFlags.Static정적 메서드를 포함 하도록 지정 합니다.Specify BindingFlags.Static to include static methods.

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

  • BindingFlags.NonPublic검색에 public이 아닌 필드 (즉, private, internal 및 protected 필드)를 포함 하도록 지정 합니다.Specify BindingFlags.NonPublic to include non-public fields (that is, private, internal, and protected fields) in the search. 기본 클래스의 보호 된 필드와 내부 필드만 반환 됩니다. 기본 클래스의 전용 필드는 반환 되지 않습니다.Only protected and internal fields on base classes are returned; private fields on base classes are not returned.

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

  • BindingFlags.Default빈 배열을 반환 하려면만 지정 PropertyInfo 합니다.Specify BindingFlags.Default alone to return an empty PropertyInfo array.

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

  • 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.

GetFields메서드는 사전순 또는 선언 순서와 같은 특정 순서로 필드를 반환 하지 않습니다.The GetFields method does not return fields in a particular order, such as alphabetical or declaration order. 코드가 반환 되는 순서에 따라 달라 지는 것은 아닙니다.Your code must not depend on the order in which fields are returned, because that order varies.

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

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

추가 정보

적용 대상