PropertyInfo.GetConstantValue Method ()

 

Returns a literal value associated with the property by a compiler.

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

public virtual object GetConstantValue()

Return Value

Type: System.Object

An Object that contains the literal value associated with the property. If the literal value is a class type with an element value of zero, the return value is null.

Exception Condition
InvalidOperationException

The Constant table in unmanaged metadata does not contain a constant value for the current property.

FormatException

The type of the value is not one of the types permitted by the Common Language Specification (CLS). See the ECMA Partition II specification, Metadata.

This method is provided for designers of managed compilers and code analyzers.

System_CAPS_noteNote

Do not use this method in the reflection-only context, because it might cause code to execute. Use the GetRawConstantValue method instead.

In unmanaged metadata, the Constant table is used to store constant values for fields, parameters, and properties. Constant information does not directly influence runtime behavior. Compilers inspect this information, at compile time, when importing metadata. If used, the value of a constant is embedded in the Microsoft intermediate language (MSIL) stream the compiler emits. There are no MSIL instructions that can be used to access the Constant table at run time.

System_CAPS_noteNote

For more information on constant values and the Constant table, see the ECMA Partition II documentation. The documentation is available online; see ECMA C# and Common Language Infrastructure Standards on MSDN and Standard ECMA-335 - Common Language Infrastructure (CLI) on the Ecma International Web site.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: