Compartilhar via


SettingsPropertyValue.PropertyValue Propriedade

Definição

Obtém ou define o valor do objeto SettingsProperty.

public:
 property System::Object ^ PropertyValue { System::Object ^ get(); void set(System::Object ^ value); };
public object PropertyValue { get; set; }
member this.PropertyValue : obj with get, set
Public Property PropertyValue As Object

Valor da propriedade

O valor do objeto SettingsProperty. Quando esse valor é definido, a propriedade IsDirty é definida como true e UsingDefaultValue é definido como false.

Quando um valor é acessado pela primeira vez da propriedade PropertyValue e se o valor foi inicialmente armazenado no objeto SettingsPropertyValue como uma representação serializada usando a propriedade SerializedValue, a propriedade PropertyValue disparará a desserialização do valor subjacente. Como um efeito colateral, a propriedade Deserialized será definida como true.

Se essa cadeia de eventos ocorrer no ASP.NET e, se ocorrer um erro durante o processo de desserialização, o erro será registrado usando o recurso de monitoramento de integridade do ASP.NET. Por padrão, isso significa que os erros de desserialização aparecerão no log de eventos do aplicativo ao ser executado no ASP.NET. Se esse processo ocorrer fora do ASP.NET e se ocorrer um erro durante a desserialização, o erro será suprimido e o restante da lógica durante a desserialização ocorrerá. Se não houver nenhum valor serializado para desserializar quando a desserialização for tentada, em seguida, o objeto SettingsPropertyValue tentará, em vez disso, retornar um valor padrão se um valor padrão tiver sido configurado conforme definido na instância SettingsProperty associada. Nesse caso, se a propriedade DefaultValue foi definida como null ou como a cadeia de caracteres "[null]", então o objeto SettingsPropertyValue inicializará a propriedade PropertyValue como null para tipos de referência ou para o valor padrão para o tipo de valor associado. Por outro lado, se a propriedade DefaultValue contiver um valor de cadeia de caracteres ou de referência de objeto válido (diferente de "[null]"), a propriedade DefaultValue será retornada.

Se não houver um valor serializado para desserializar quando for tentada a desserialização e nenhum valor padrão tiver sido especificado, uma cadeia de caracteres vazia será retornada para os tipos de cadeia de caracteres. Para todos os outros tipos, uma instância padrão será retornada chamando CreateInstance(Type) - para tipos de referência, isso significa que será feita uma tentativa de criar uma instância de objeto usando o construtor sem parâmetros. Se essa tentativa falhar, então null será retornado.

Exceções

Ocorreu um erro ao tentar usar o valor padrão da propriedade DefaultValue. A tentativa de converter a propriedade DefaultValue em um tipo válido falhou ou o valor resultante não era compatível com o tipo definido pelo PropertyType.

Aplica-se a