ConfigurationSection.GetRuntimeObject Método

Definição

Espaço de Nomes:
System.Configuration
Assemblagem:
System.Configuration.dll

Devolve um objeto personalizado quando sobrescrito numa 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

Devoluções

Object

O objeto que representa a secção.

Exemplos

O exemplo seguinte mostra como usar o GetRuntimeObject método.

// 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

Observações

Quando o GetSection método é chamado em tempo de execução, o sistema de configuração cria primeiro uma instância apropriada da ConfigurationSection classe e depois devolve o objeto que obtém do GetRuntimeObject método.

Por defeito, GetRuntimeObject simplesmente devolve o objeto que representa o ConfigurationSection de onde é chamado.

Notas para Herdeiros

Podes sobrescrever o GetRuntimeObject() método para devolver um tipo personalizado em tempo de execução.

Por exemplo, para restringir a modificação em tempo de execução das definições na ConfigurationSection classe, pode sobrescrever GetRuntimeObject() e devolver um tipo personalizado que impõe restrições sobre quais definições podem ser modificadas, se existem.

Se o objeto de execução for apenas interno, o objeto devolvido não pode ser usado fora da montagem que o define. Uma forma de criar um objeto que deriva de ConfigurationSection e só pode ser acedido por código na sua assembly em tempo de execução é criar um objeto interno em tempo de execução que tenha um método que devolve a sua ConfigurationSection implementação.

Aplica-se a