ConfigurationSection.GetRuntimeObject Método

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationSection.cs

Devuelve un objeto personalizado cuando se reemplaza en una clase 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

Devoluciones

Object

Objeto que representa la sección.

Ejemplos

En el siguiente ejemplo, se muestra cómo utilizar el 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

Comentarios

Cuando se llama al GetSection método en tiempo de ejecución, el sistema de configuración crea primero una instancia adecuada de la ConfigurationSection clase y, a continuación, devuelve el objeto que obtiene del GetRuntimeObject método .

De forma predeterminada, GetRuntimeObject simplemente devuelve el objeto que representa el desde el ConfigurationSection que se llama.

Notas a los desarrolladores de herederos

Puede invalidar el GetRuntimeObject() método para devolver un tipo personalizado en tiempo de ejecución.

Por ejemplo, para restringir la modificación en tiempo de ejecución de la configuración de la ConfigurationSection clase , puede invalidar GetRuntimeObject() y devolver un tipo personalizado que aplique restricciones sobre qué configuración se puede modificar, si existe.

Si el objeto en tiempo de ejecución solo es interno, el objeto devuelto no se puede usar fuera del ensamblado que lo define. Una manera de crear un objeto derivado de ConfigurationSection y al que solo puede acceder el código del ensamblado en tiempo de ejecución es crear un objeto en tiempo de ejecución interno que tenga un método que devuelva la ConfigurationSection implementación.