Type.GetProperties 메서드

정의

현재 Type의 속성을 가져옵니다.

오버로드

GetProperties()

현재 Type의 모든 public 속성을 반환합니다.

GetProperties(BindingFlags)

파생 클래스에서 재정의되면, 현재 Type의 속성을 지정된 바인딩 제약 조건으로 검색합니다.

GetProperties()

Source:
Type.cs
Source:
Type.cs
Source:
Type.cs

현재 Type의 모든 public 속성을 반환합니다.

public System.Reflection.PropertyInfo[] GetProperties ();

반환

현재 PropertyInfo의 모든 public 속성을 나타내는 Type 개체의 배열입니다.

또는

현재 PropertyInfo에 public 속성이 없을 경우 Type 형식의 빈 배열입니다.

구현

예제

다음 예제에서는 GetProperties 메서드를 사용하는 방법을 보여 줍니다.

PropertyInfo[] myPropertyInfo;
// Get the properties of 'Type' class object.
myPropertyInfo = Type.GetType("System.Type").GetProperties();
Console.WriteLine("Properties of System.Type are:");
for (int i = 0; i < myPropertyInfo.Length; i++)
{
    Console.WriteLine(myPropertyInfo[i].ToString());
}

설명

이 오버로드를 호출하는 것은 C# 및 BindingFlags.Instance Or BindingFlags.Static Or BindingFlags.Public Visual Basic에서 와 같은 인수를 사용하여 bindingAttr 오버로드를 호출 GetProperties(BindingFlags) 하는 것과 BindingFlags.Instance | BindingFlags.Static | BindingFlags.Public 같습니다. 현재 Type 개체가 나타내는 형식과 기본 형식에서 상속된 속성으로 정의된 모든 공용 instance 및 정적 속성을 반환합니다.

속성이 public인 접근자가 하나 이상 있는 경우 리플렉션에 public으로 간주됩니다. 그렇지 않으면 속성은 프라이빗으로 간주되며 를 사용하여 BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static 가져와야 합니다(Visual Basic에서는 를 사용하여 Or값을 결합).

.NET 6 및 이전 버전 GetProperties 에서 메서드는 사전순 또는 선언 순서와 같은 특정 순서로 속성을 반환하지 않습니다. 해당 순서가 다르기 때문에 속성이 반환되는 순서에 따라 코드가 달라지지 않아야 합니다. 그러나 .NET 7부터는 어셈블리의 메타데이터 순서에 따라 순서가 결정적입니다.

다음 표에서는 형식을 반영할 때 메서드에서 반환되는 기본 클래스의 Get 멤버를 보여 줍니다.

멤버 형식 정적 비정적
생성자 아니요 아니요
필드 아니요 예. 필드는 항상 이름별 및 서명으로 숨깁니다.
이벤트 해당 없음 일반적인 형식 시스템 규칙은 상속이 속성을 구현하는 메서드의 상속과 동일하다는 것입니다. 리플렉션은 속성을 hide-by-name-and-signature으로 처리합니다. 아래의 참고 2를 참조하세요.
메서드 아니요 예. 메서드(가상 및 가상이 아닌 메서드)는 이름별 숨기기 또는 이름별 숨기기 및 서명일 수 있습니다.
중첩 형식 아니요 아니요
속성 해당 없음 일반적인 형식 시스템 규칙은 상속이 속성을 구현하는 메서드의 상속과 동일하다는 것입니다. 리플렉션은 속성을 hide-by-name-and-signature으로 처리합니다. 아래의 참고 2를 참조하세요.
  1. 이름별 숨기기 및 서명은 사용자 지정 한정자, 반환 형식, 매개 변수 형식, sentinels 및 관리되지 않는 호출 규칙을 포함하여 서명의 모든 부분을 고려합니다. 이진 비교입니다.

  2. 리플렉션의 경우 속성 및 이벤트는 이름별 숨기기 및 서명입니다. 기본 클래스에 get 및 set 접근자가 둘 다 있는 속성이 있지만 파생 클래스에 get 접근자만 있는 경우 파생 클래스 속성은 기본 클래스 속성을 숨기며 기본 클래스의 setter에 액세스할 수 없습니다.

  3. 사용자 지정 특성은 공통 형식 시스템의 일부가 아닙니다.

현재 Type 가 생성된 제네릭 형식을 나타내는 경우 이 메서드는 형식 매개 변수가 적절한 형식 인수로 대체된 개체를 반환 PropertyInfo 합니다.

현재 Type 가 제네릭 형식 또는 제네릭 메서드의 정의에서 형식 매개 변수를 나타내는 경우 이 메서드는 클래스 제약 조건의 속성을 검색합니다.

추가 정보

적용 대상

.NET 9 및 기타 버전
제품 버전
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetProperties(BindingFlags)

Source:
Type.cs
Source:
Type.cs
Source:
Type.cs

파생 클래스에서 재정의되면, 현재 Type의 속성을 지정된 바인딩 제약 조건으로 검색합니다.

public abstract System.Reflection.PropertyInfo[] GetProperties (System.Reflection.BindingFlags bindingAttr);

매개 변수

bindingAttr
BindingFlags

검색 방법을 지정하는 열거형 값의 비트 조합입니다.

또는

빈 배열을 반환하는 Default입니다.

반환

현재 Type의 속성 중 지정된 바인딩 제약 조건과 일치하는 모든 속성을 나타내는 개체의 배열입니다.

또는

현재 PropertyInfo에 속성이 없거나 해당 바인딩 제약 조건과 일치하는 속성이 없을 경우 Type 형식의 빈 배열입니다.

구현

예제

다음 예제에서는 6개의 속성을 포함하는 라는 PropertyClass 클래스를 정의합니다. 두 속성은 public이고, 하나는 private이고, 하나는 보호되고, 하나는 내부(Friend Visual Basic에서는 )이고, 다른 하나는 내부(Protected Friend Visual Basic에서는 보호됨)입니다. 그런 다음 지정된 바인딩 제약 조건과 일치하는 속성에 대한 몇 가지 기본 속성 정보(속성 이름 및 형식, 읽기/쓰기 여부 및 해당 getset 접근자의 표시 여부)를 표시합니다.

using System;
using System.Reflection;

// Create a class having six properties.
public class PropertyClass
{
    public String Property1
    {
        get { return "hello"; }
    }

    public String Property2
    {
        get { return "hello"; }
    }

    protected String Property3
    {
        get { return "hello"; }
    }

    private Int32 Property4
    {
        get { return 32; }
    }

    internal String Property5
    {
       get { return "value"; }
    }

    protected internal String Property6
    {
       get { return "value"; }
    }
}

public class Example
{
    public static void Main()
    {
        Type t = typeof(PropertyClass);
        // Get the public properties.
        PropertyInfo[] propInfos = t.GetProperties(BindingFlags.Public|BindingFlags.Instance);
        Console.WriteLine("The number of public properties: {0}.\n",
                          propInfos.Length);
        // Display the public properties.
        DisplayPropertyInfo(propInfos);

        // Get the nonpublic properties.
        PropertyInfo[] propInfos1 = t.GetProperties(BindingFlags.NonPublic|BindingFlags.Instance);
        Console.WriteLine("The number of non-public properties: {0}.\n",
                          propInfos1.Length);
        // Display all the nonpublic properties.
        DisplayPropertyInfo(propInfos1);
    }

    public static void DisplayPropertyInfo(PropertyInfo[] propInfos)
    {
        // Display information for all properties.
        foreach (var propInfo in propInfos) {
            bool readable = propInfo.CanRead;
            bool writable = propInfo.CanWrite;

            Console.WriteLine("   Property name: {0}", propInfo.Name);
            Console.WriteLine("   Property type: {0}", propInfo.PropertyType);
            Console.WriteLine("   Read-Write:    {0}", readable & writable);
            if (readable) {
               MethodInfo getAccessor = propInfo.GetMethod;
               Console.WriteLine("   Visibility:    {0}",
                                 GetVisibility(getAccessor));
            }
            if (writable) {
               MethodInfo setAccessor = propInfo.SetMethod;
               Console.WriteLine("   Visibility:    {0}",
                                 GetVisibility(setAccessor));
            }
            Console.WriteLine();
        }
    }

    public static String GetVisibility(MethodInfo accessor)
    {
       if (accessor.IsPublic)
          return "Public";
       else if (accessor.IsPrivate)
          return "Private";
       else if (accessor.IsFamily)
          return "Protected";
       else if (accessor.IsAssembly)
          return "Internal/Friend";
       else
          return "Protected Internal/Friend";
    }
}
// The example displays the following output:
//       The number of public properties: 2.
//
//          Property name: Property1
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Public
//
//          Property name: Property2
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Public
//
//       The number of non-public properties: 4.
//
//          Property name: Property3
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Protected
//
//          Property name: Property4
//          Property type: System.Int32
//          Read-Write:    False
//          Visibility:    Private
//
//          Property name: Property5
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Internal/Friend
//
//          Property name: Property6
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Protected Internal/Friend

설명

오버로드가 GetProperties(BindingFlags) 속성 정보를 bindingAttr 성공적으로 검색하려면 인수에 및 중 BindingFlags.Instance 하나 이상과 및 BindingFlags.StaticBindingFlags.PublicBindingFlags.NonPublic 하나 이상이 포함되어야 합니다.

다음 BindingFlags 필터 플래그를 사용하여 검색에 포함할 속성을 정의할 수 있습니다.

  • instance 메서드를 포함하도록 지정 BindingFlags.Instance 합니다.

  • 정적 메서드를 포함하도록 지정 BindingFlags.Static 합니다.

  • 검색에 공용 속성을 포함하도록 지정 BindingFlags.Public 합니다. 속성이 public인 접근자가 하나 이상 있는 경우 리플렉션에 public으로 간주됩니다.

  • 검색에 공용이 아닌 속성(즉, 프라이빗, 내부 및 보호된 속성)을 포함하도록 지정 BindingFlags.NonPublic 합니다. 기본 클래스의 보호된 속성과 내부 속성만 반환됩니다. 기본 클래스의 private 속성은 반환되지 않습니다.

  • 계층을 포함 public 하도록 지정 BindingFlags.FlattenHierarchy 하고 protected 정적 멤버를 지정합니다private. 상속된 클래스의 정적 멤버는 포함되지 않습니다.

  • PropertyInfo 배열을 반환하려면 단독으로 지정 BindingFlags.Default 합니다.

다음 BindingFlags 한정자 플래그를 사용하여 검색 작동 방식을 변경할 수 있습니다.

  • BindingFlags.DeclaredOnly 에 선언된 Type속성만 검색하려면 이고, 단순히 상속된 속성은 검색하지 않습니다.

자세한 내용은 System.Reflection.BindingFlags를 참조하세요.

.NET 6 및 이전 버전 GetProperties 에서 메서드는 사전순 또는 선언 순서와 같은 특정 순서로 속성을 반환하지 않습니다. 해당 순서가 다르기 때문에 속성이 반환되는 순서에 따라 코드가 달라지지 않아야 합니다. 그러나 .NET 7부터는 어셈블리의 메타데이터 순서에 따라 순서가 결정적입니다.

현재 Type 가 생성된 제네릭 형식을 나타내는 경우 이 메서드는 형식 매개 변수가 적절한 형식 인수로 대체된 개체를 반환 PropertyInfo 합니다.

현재 Type 가 제네릭 형식 또는 제네릭 메서드의 정의에서 형식 매개 변수를 나타내는 경우 이 메서드는 클래스 제약 조건의 속성을 검색합니다.

추가 정보

적용 대상

.NET 9 및 기타 버전
제품 버전
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1