Export (0) Print
Expand All
5 out of 11 rated this helpful - Rate this topic

PropertyInfo Class

Discovers the attributes of a property and provides access to property metadata.

Namespace:  System.Reflection
Assembly:  mscorlib (in mscorlib.dll)
[SerializableAttribute]
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.None)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public abstract class PropertyInfo : MemberInfo, 
	_PropertyInfo

Properties are logically the same as fields. A property is a named aspect of an object's state whose value is typically accessible through get and set accessors. Properties may be read-only, in which case a set routine is not supported.

NoteNote:

To determine whether a property is static, you must obtain the MethodInfo for the get or set accessor, by calling the GetGetMethod or the GetSetMethod method, and examine its IsStatic property.

Several methods in this class assume that the get accessor and set accessor methods of a property have certain formats. The signatures of the get and set methods must match the following convention:

  • The return type of the get method and the last argument of the set method must be identical. This is the type of the property.

  • The get and set methods must have the same number, type, and order of indices.

If this format is not followed, the behavior of the GetValue and SetValue methods is undefined.

Calling ICustomAttributeProvider.GetCustomAttributes on PropertyInfo when the inherit parameter of GetCustomAttributes is true does not walk the type hierarchy. Use System.Attribute to inherit custom attributes.

Notes to Inheritors:

When you inherit from PropertyInfo, you must override the following members: GetValue, SetValue, GetAccessors, GetGetMethod, GetSetMethod, and GetIndexParameters.

This example shows how to use various reflection classes to analyze the metadata contained in an assembly.

NoteNote:

This example generates about 55,000 lines of data, which you can redirect to a text file at the command prompt, as follows: example.exe > propertyinfo.txt

using System;
using System.Reflection;

class Module1
{

    public static void Main()
    {
        // This variable holds the amount of indenting that  
        // should be used when displaying each line of information.
        Int32 indent = 0;
        // Display information about the EXE assembly.
        Assembly a = System.Reflection.Assembly.GetExecutingAssembly();
        Display(indent, "Assembly identity={0}", a.FullName);
        Display(indent+1, "Codebase={0}", a.CodeBase);

        // Display the set of assemblies our assemblies reference.

        Display(indent, "Referenced assemblies:");
        foreach (AssemblyName an in a.GetReferencedAssemblies() )
        {
             Display(indent + 1, "Name={0}, Version={1}, Culture={2}, PublicKey token={3}", an.Name, an.Version, an.CultureInfo.Name, (BitConverter.ToString (an.GetPublicKeyToken())));
        }
        Display(indent, "");

        // Display information about each assembly loading into this AppDomain. 
        foreach (Assembly b in AppDomain.CurrentDomain.GetAssemblies())
        {
            Display(indent, "Assembly: {0}", b);

            // Display information about each module of this assembly. 
            foreach ( Module m in b.GetModules(true) )
            {
                Display(indent+1, "Module: {0}", m.Name);
            }

            // Display information about each type exported from this assembly.

            indent += 1;
            foreach ( Type t in b.GetExportedTypes() )
            {
                Display(0, "");
                Display(indent, "Type: {0}", t);

                // For each type, show its members & their custom attributes.

                indent += 1;
                foreach (MemberInfo mi in t.GetMembers() )
                {
                    Display(indent, "Member: {0}", mi.Name);
                    DisplayAttributes(indent, mi);

                    // If the member is a method, display information about its parameters. 

                    if (mi.MemberType==MemberTypes.Method)
                    {
                        foreach ( ParameterInfo pi in ((MethodInfo) mi).GetParameters() )
                        {
                            Display(indent+1, "Parameter: Type={0}, Name={1}", pi.ParameterType, pi.Name);
                        }
                    }

                    // If the member is a property, display information about the property's accessor methods. 
                    if (mi.MemberType==MemberTypes.Property)
                    {
                        foreach ( MethodInfo am in ((PropertyInfo) mi).GetAccessors() )
                        {
                            Display(indent+1, "Accessor method: {0}", am);
                        }
                    }
                }
                indent -= 1;
            }
            indent -= 1;
        }
    }

    // Displays the custom attributes applied to the specified member. 
    public static void DisplayAttributes(Int32 indent, MemberInfo mi)
    {
        // Get the set of custom attributes; if none exist, just return.
        object[] attrs = mi.GetCustomAttributes(false);
        if (attrs.Length==0) {return;}

        // Display the custom attributes applied to this member.
        Display(indent+1, "Attributes:");
        foreach ( object o in attrs )
        {
            Display(indent+2, "{0}", o.ToString());
        }
    }

    // Display a formatted string indented by the specified amount. 
    public static void Display(Int32 indent, string format, params object[] param) 

    {
        Console.Write(new string(' ', indent*2));
        Console.WriteLine(format, param);
    }
}

//The output shown below is abbreviated. 
// 
//Assembly identity=ReflectionCS, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null 
//  Codebase=file:///C:/Documents and Settings/test/My Documents/Visual Studio 2005/Projects/Reflection/Reflection/obj/Debug/Reflection.exe 
//Referenced assemblies: 
//  Name=mscorlib, Version=2.0.0.0, Culture=, PublicKey token=B7-7A-5C-56-19-34-E0-89 
// 
//Assembly: mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
//  Module: mscorlib.dll 
// 
//  Type: System.Object 
//    Member: GetType 
//    Member: ToString 
//    Member: Equals 
//      Parameter: Type=System.Object, Name=obj 
//    Member: Equals 
//      Parameter: Type=System.Object, Name=objA 
//      Parameter: Type=System.Object, Name=objB 
//    Member: ReferenceEquals 
//      Attributes: 
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute 
//      Parameter: Type=System.Object, Name=objA 
//      Parameter: Type=System.Object, Name=objB 
//    Member: GetHashCode 
//    Member: .ctor 
//      Attributes: 
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute 
// 
//  Type: System.ICloneable 
//    Member: Clone 
// 
//  Type: System.Collections.IEnumerable 
//    Member: GetEnumerator 
//      Attributes: 
//        System.Runtime.InteropServices.DispIdAttribute 
// 
//  Type: System.Collections.ICollection 
//    Member: CopyTo 
//      Parameter: Type=System.Array, Name=array 
//      Parameter: Type=System.Int32, Name=index 
//    Member: get_Count 
//    Member: get_SyncRoot 
//    Member: get_IsSynchronized 
//    Member: Count 
//      Accessor method: Int32 get_Count() 
//    Member: SyncRoot 
//      Accessor method: System.Object get_SyncRoot() 
//    Member: IsSynchronized 
//      Accessor method: Boolean get_IsSynchronized() 
// 
//  Type: System.Collections.IList 
//    Member: get_Item 
//      Parameter: Type=System.Int32, Name=index 
//    Member: set_Item 
//      Parameter: Type=System.Int32, Name=index 
//      Parameter: Type=System.Object, Name=value 
//    Member: Add 
//      Parameter: Type=System.Object, Name=value 
//    Member: Contains 
//      Parameter: Type=System.Object, Name=value 
//    Member: Clear 
//    Member: get_IsReadOnly 
//    Member: get_IsFixedSize 
//    Member: IndexOf 
//      Parameter: Type=System.Object, Name=value 
//    Member: Insert 
//      Parameter: Type=System.Int32, Name=index 
//      Parameter: Type=System.Object, Name=value 
//    Member: Remove 
//      Parameter: Type=System.Object, Name=value 
//    Member: RemoveAt 
//      Parameter: Type=System.Int32, Name=index 
//    Member: Item 
//      Accessor method: System.Object get_Item(Int32) 
//      Accessor method: Void set_Item(Int32, System.Object) 
//    Member: IsReadOnly 
//      Accessor method: Boolean get_IsReadOnly() 
//    Member: IsFixedSize 
//      Accessor method: Boolean get_IsFixedSize() 
// 
//  Type: System.Array 
//    Member: IndexOf 
//      Parameter: Type=T[], Name=array 
//      Parameter: Type=T, Name=value 
//    Member: AsReadOnly 
//      Parameter: Type=T[], Name=array 
//    Member: Resize 
//      Attributes: 
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute 
//      Parameter: Type=T[]&, Name=array 
//      Parameter: Type=System.Int32, Name=newSize 
//    Member: BinarySearch 
//      Attributes: 
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute 
//      Parameter: Type=T[], Name=array 
//      Parameter: Type=T, Name=value 
//    Member: BinarySearch 
//      Attributes: 
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute 
//      Parameter: Type=T[], Name=array 
//      Parameter: Type=T, Name=value 
//      Parameter: Type=System.Collections.Generic.IComparer`1[T], Name=comparer

This type is thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.