PropertyInfo.GetConstantValue Método

Definição

Retorna um valor literal associado à propriedade por um compilador.Returns a literal value associated with the property by a compiler.

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

Um Object que contém o valor literal associado à propriedade.An Object that contains the literal value associated with the property. Se o valor literal for um tipo de classe com um valor de elemento zero, o valor retornado será null.If the literal value is a class type with an element value of zero, the return value is null.

Exceções

A tabela constante nos metadados não gerenciados não contém um valor constante para a propriedade atual.The Constant table in unmanaged metadata does not contain a constant value for the current property.

O tipo do valor não é um dos tipos permitidos pelo CLS (Common Language Specification).The type of the value is not one of the types permitted by the Common Language Specification (CLS). Consulte a especificação ECMA Partição II, metadados.See the ECMA Partition II specification, Metadata.

Comentários

Esse método é fornecido para designers de compiladores gerenciados e analisadores de código.This method is provided for designers of managed compilers and code analyzers.

Observação

Não use esse método no contexto somente de reflexão, pois ele pode fazer com que o código seja executado.Do not use this method in the reflection-only context, because it might cause code to execute. Use o método GetRawConstantValue em seu lugar.Use the GetRawConstantValue method instead.

Em metadados não gerenciados, a tabela constante é usada para armazenar valores constantes para campos, parâmetros e propriedades.In unmanaged metadata, the Constant table is used to store constant values for fields, parameters, and properties. As informações constantes não influenciam diretamente o comportamento do tempo de execução.Constant information does not directly influence runtime behavior. Os compiladores inspecionam essas informações, em tempo de compilação, ao importar metadados.Compilers inspect this information, at compile time, when importing metadata. Se usado, o valor de uma constante é inserido no fluxo MSIL (Microsoft Intermediate Language) que o compilador emite.If used, the value of a constant is embedded in the Microsoft intermediate language (MSIL) stream the compiler emits. Não há instruções MSIL que possam ser usadas para acessar a tabela constante em tempo de execução.There are no MSIL instructions that can be used to access the Constant table at run time.

Observação

Para obter mais informações sobre valores constantes e a tabela constante, consulte a documentação da ECMA Partition II.For more information on constant values and the Constant table, see the ECMA Partition II documentation. A documentação está disponível online; confira ECMA C# and Common Language Infrastructure Standards, no MSDN, e Standard ECMA-335 - Common Language Infrastructure (CLI), no site internacional da Ecma.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.

Aplica-se a