Export (0) Print
Expand All

PropertyInfo Class

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

Namespace:  System.Reflection
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.None)> _
Public MustInherit Class PropertyInfo _
	Inherits MemberInfo

The PropertyInfo type exposes the following members.

  NameDescription
Protected methodPropertyInfoInitializes a new instance of the PropertyInfo class.
Top

  NameDescription
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360AttributesGets the attributes for this property.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360CanReadGets a value indicating whether the property can be read.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360CanWriteGets a value indicating whether the property can be written to.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360DeclaringTypeGets the class that declares this member. (Inherited from MemberInfo.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360IsSpecialNameGets a value indicating whether the name of the property is recognized as a special name by compilers.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360MemberTypeGets a MemberTypes value indicating that this member is a property. (Overrides MemberInfo.MemberType.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360MetadataTokenGets a value that identifies a metadata element. (Inherited from MemberInfo.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360ModuleGets the module in which the type that declares the member represented by the current MemberInfo is defined. (Inherited from MemberInfo.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360NameGets the name of the current member. (Inherited from MemberInfo.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360PropertyTypeGets the type of this property.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360ReflectedTypeGets the class object that was used to obtain this instance of MemberInfo. (Inherited from MemberInfo.)
Top

  NameDescription
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360Equals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360FinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetAccessorsReturns an array whose elements reflect the public get, set, and other accessors of the property reflected by the current instance.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetAccessors(Boolean)Returns an array whose elements reflect the public (and, if specified, non-public) get, set, and other accessors of the property reflected by the current instance.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetConstantValueReturns a literal value associated with the property by a compiler.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetCustomAttributes(Boolean)When overridden in a derived class, returns an array of all custom attributes applied to this member. (Inherited from MemberInfo.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetCustomAttributes(Type, Boolean)When overridden in a derived class, returns an array of custom attributes applied to this member and identified by Type. (Inherited from MemberInfo.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetGetMethodReturns the public get accessor for this property.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetGetMethod(Boolean)When overridden in a derived class, returns the public or non-public get accessor for this property.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetIndexParametersWhen overridden in a derived class, returns an array of all the index parameters for the property.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetRawConstantValueReturns a literal value associated with the property by a compiler.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetSetMethodReturns the public set accessor for this property.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetSetMethod(Boolean)When overridden in a derived class, returns the set accessor for this property.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetValue(Object, Object())Returns the value of the property with optional index values for indexed properties.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetValue(Object, BindingFlags, Binder, Object(), CultureInfo)When overridden in a derived class, returns the value of a property that has the specified binding, index, and CultureInfo.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360IsDefinedWhen overridden in a derived class, indicates whether one or more attributes of the specified type or of its derived types is applied to this member. (Inherited from MemberInfo.)
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360MemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360SetValue(Object, Object, Object())Sets the value of the property on the specified object, with optional index values for indexed properties.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360SetValue(Object, Object, BindingFlags, Binder, Object(), CultureInfo)When overridden in a derived class, sets the property value for the given object to the given value, subject to the specified binding constraints, binder, and culture.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ToStringReturns a string that represents the current object. (Inherited from Object.)
Top

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 there is no set accessor.

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.

Calling ICustomAttributeProvider.GetCustomAttributes on PropertyInfo and specifying true for the inherit parameter does not walk the type hierarchy. Use the Attribute.GetCustomAttributes(MemberInfo, Boolean) method to list inherited custom attributes. Note, however, that even this method finds only those inherited custom attributes that derive from System.Attribute.

The following example shows how to get the value of an indexed property using reflection. The String.Chars property is the default property (the indexer in C#) of the String class.


Imports System.Reflection

Class Example

   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock) 

        Dim test As String = "abcdefghijklmnopqrstuvwxyz"

        ' To retrieve the value of the indexed Chars property  using 
        ' reflection, create an instance of PropertyInfo for Chars.
        '
        Dim pinfo As PropertyInfo = GetType(String).GetProperty("Chars")

        ' To retrieve an instance property, the GetValue method
        ' requires the object whose property is being accessed, and 
        ' an array of objects representing the index values. 

        ' Get the seventh character in the test string. 
        ' Note that the index is zero-based.
        Dim indexArgs() As Object = { 6 }
        Dim value As Object = pinfo.GetValue(test, indexArgs)
        outputBlock.Text &= _
            String.Format("The character at index 6 is ""{0}""." & vbLf, value)

        ' Show the complete string, one character at a time.
        For i As Integer = 0 To test.Length - 1
            outputBlock.Text &= pinfo.GetValue(test, New Object() { i })
        Next
        outputBlock.Text &= vbLf

    End Sub

End Class

' This example produces the following output:
'
'The character at index 6 is "g".
'abcdefghijklmnopqrstuvwxyz


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

This type is thread safe.

Community Additions

ADD
Show:
© 2015 Microsoft