ConfigurationSection.GetRuntimeObject Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

ConfigurationSection.cs

Retorna um objeto personalizado quando substituído em uma classe derivada.

protected public:
 virtual System::Object ^ GetRuntimeObject();

protected internal virtual object GetRuntimeObject ();

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

Protected Friend Overridable Function GetRuntimeObject () As Object

Retornos

Object

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.