ConfigurationSection.GetRuntimeObject Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna um objeto personalizado quando substituído em uma classe derivada.
protected:
virtual System::Object ^ GetRuntimeObject();protected public:
virtual System::Object ^ GetRuntimeObject();protected virtual object GetRuntimeObject ();protected internal virtual object GetRuntimeObject ();abstract member GetRuntimeObject : unit -> obj
override this.GetRuntimeObject : unit -> objProtected Overridable Function GetRuntimeObject () As ObjectProtected Friend Overridable Function GetRuntimeObject () As ObjectRetornos
O objeto que representa a seção.
Exemplos
O exemplo a seguir mostra como usar o método GetRuntimeObject.
// Customizes the use of CustomSection
// by setting _ReadOnly to false.
// Remember you must use it along with ThrowIfReadOnly.
protected override object GetRuntimeObject()
{
// To enable property setting just assign true to
// the following flag.
_ReadOnly = true;
return base.GetRuntimeObject();
}
' Customizes the use of CustomSection
' by setting _ReadOnly to false.
' Remember you must use it along with ThrowIfReadOnly.
Protected Overrides Function GetRuntimeObject() As Object
' To enable property setting just assign true to
' the following flag.
_ReadOnly = True
Return MyBase.GetRuntimeObject()
End Function 'GetRuntimeObject
Comentários
Quando o GetSection método é chamado em tempo de execução, o sistema de configuração primeiro cria uma instância apropriada da ConfigurationSection classe e, em seguida, retorna o objeto obtido do GetRuntimeObject método .
Por padrão, GetRuntimeObject simplesmente retorna o objeto que representa o ConfigurationSection do qual ele é chamado.
Notas aos Herdeiros
Você pode substituir o GetRuntimeObject() método para retornar um tipo personalizado em tempo de execução.
Por exemplo, para restringir a modificação de runtime das configurações na ConfigurationSection classe , você pode substituir GetRuntimeObject() e retornar um tipo personalizado que impõe restrições sobre quais configurações podem ser modificadas, se houver.
Se o objeto de runtime for somente interno, o objeto retornado não poderá ser usado fora do assembly que o define. Uma maneira de criar um objeto que deriva de ConfigurationSection e só pode ser acessado pelo código em seu assembly em tempo de execução é criar um objeto de runtime interno que tenha um método que retorna sua ConfigurationSection implementação.
