PropertyInfo.GetConstantValue メソッド

.NET Framework クラス ライブラリ リファレンス

PropertyInfo.GetConstantValue メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

コンパイラによってプロパティに関連付けられているリテラル値を返します。

名前空間: System.Reflection
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 GetConstantValue As Object

Visual Basic (使用法)

Dim instance As PropertyInfo
Dim returnValue As Object

returnValue = instance.GetConstantValue

C#

public virtual Object GetConstantValue ()

C++

public:
virtual Object^ GetConstantValue ()

J#

public Object GetConstantValue ()

JScript

public function GetConstantValue () : Object

戻り値
プロパティに関連付けられているリテラル値を格納している Object。リテラル値が、要素値がゼロに設定されているクラス型である場合、戻り値は null 参照 (Visual Basic では Nothing) です。

例外

例外の種類	条件
InvalidOperationException	アンマネージ メタデータの定数テーブルに、現在のプロパティの定数値が含まれていません。
FormatException	値の型が、共通言語仕様 (CLS: Common Language Specification) で許可されている型のいずれでもありません。ECMA Partition II のメタデータの仕様 (22.1.15) を参照してください。

解説

このメソッドは、マネージ コンパイラおよびコード アナライザのデザイナ向けに提供されています。

メモ
このメソッドはリフレクションのみのコンテキストでは使用しないでください。コードが実行される可能性があります。代わりに、GetRawConstantValue を使用してください。

アンマネージ メタデータでは、定数テーブルを使用して、フィールド、パラメータ、およびプロパティの定数値を格納します。定数情報が実行時の動作に直接影響を与えることはありません。コンパイラは、コンパイル時にメタデータをインポートする際に、この情報を検査します。定数の値を使用する場合、その値は、コンパイラが出力する MSIL (Microsoft Intermediate Language) ストリームに埋め込まれます。実行時に定数テーブルにアクセスするために使用できる MSIL 命令はありません。

メモ
定数値および定数テーブルの詳細については、ECMA Partition II のドキュメントを参照してください。Partition II のドキュメントは、http://msdn.microsoft.com/net/ecma/ および http://www.ecma-international.org/publications/standards/Ecma-335.htm で入手できます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PropertyInfo クラス
PropertyInfo メンバ
System.Reflection 名前空間