PropertyInfo.GetConstantValue Método

Definição

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Origem:

PropertyInfo.cs

Retorna um valor literal associado à propriedade por um compilador.

public:
 virtual System::Object ^ GetConstantValue();

public virtual object? GetConstantValue ();

abstract member GetConstantValue : unit -> obj
override this.GetConstantValue : unit -> obj

Public Overridable Function GetConstantValue () As Object

Retornos

Object

Um Object que contém o valor literal associado à propriedade. Se o valor literal for um tipo de classe com um valor de elemento zero, o valor retornado será null.

Exceções

InvalidOperationException

A tabela constante nos metadados não gerenciados não contém um valor constante para a propriedade atual.

FormatException

O tipo do valor não é um dos tipos permitidos pelo CLS (Common Language Specification). Consulte a especificação ECMA Partição II, metadados.

Comentários

Esse método é fornecido para designers de compiladores gerenciados e analisadores de código.

Observação

Não use esse método no contexto somente reflexão, pois ele pode fazer com que o código seja executado. Use o método GetRawConstantValue em seu lugar.

Em metadados não gerenciados, a tabela Constante é usada para armazenar valores constantes para campos, parâmetros e propriedades. As informações constantes não influenciam diretamente o comportamento do runtime. Os compiladores inspecionam essas informações, em tempo de compilação, ao importar metadados. Se usado, o valor de uma constante é inserido no fluxo msil (linguagem intermediária da Microsoft) que o compilador emite. Não há instruções MSIL que possam ser usadas para acessar a tabela Constante em tempo de execução.

Observação

Para obter mais informações sobre valores constantes e a tabela Constante, consulte Partição II da especificação da CLI (Common Language Infrastructure).