ConfigurationSection.GetRuntimeObject Method

Definition

Retorna um objeto personalizado quando substituído em uma classe derivada.Returns a custom object when overridden in a derived class.

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 -> obj
Protected Overridable Function GetRuntimeObject () As Object
Protected Friend Overridable Function GetRuntimeObject () As Object

Returns

Object

O objeto que representa a seção.The object representing the section.

Examples

O exemplo a seguir mostra como usar o método GetRuntimeObject.The following example shows how to use the GetRuntimeObject method.

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

Remarks

Quando o método de GetSection é chamado em tempo de execução, o sistema de configuração primeiro cria uma instância apropriada da classe ConfigurationSection e retorna o objeto obtido do método GetRuntimeObject.When the GetSection method is called at run time, the configuration system first creates an appropriate instance of the ConfigurationSection class, and then returns the object it obtains from the GetRuntimeObject method.

Por padrão, GetRuntimeObject simplesmente retorna o objeto que representa o ConfigurationSection do qual ele é chamado.By default, GetRuntimeObject simply returns the object that represents the ConfigurationSection from which it is called.

Notes to Inheritors

Você pode substituir o método GetRuntimeObject() para retornar um tipo personalizado em tempo de execução.You can override the GetRuntimeObject() method to return a custom type at run time.

Por exemplo, para restringir a modificação de tempo de execução das configurações na classe ConfigurationSection, você pode substituir GetRuntimeObject() e retornar um tipo personalizado que impõe restrições nas quais as configurações podem ser modificadas, se houver.For example, to restrict runtime modification of the settings in the ConfigurationSection class, you can override GetRuntimeObject() and return a custom type that enforces restrictions on which settings can be modified, if any.

Se o objeto de tempo de execução for somente interno, o objeto retornado não poderá ser usado fora do assembly que o define.If the runtime object is internal only, the returned object cannot be used outside the assembly that defines it. 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 tempo de execução interno que tenha um método que retorne sua implementação de ConfigurationSection.One way to create an object that derives from ConfigurationSection and can only be accessed by code in your assembly at run time is to create an internal runtime object that has a method that returns your ConfigurationSection implementation.

Applies to