ConfigurationSection.GetRuntimeObject Método

Definición

Devuelve un objeto personalizado cuando se reemplaza en una clase derivada.Returns a custom object when overridden in a derived class.

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

Objeto que representa la sección.The object representing the section.

Ejemplos

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

Comentarios

Cuando se llama al ConfigurationSection GetRuntimeObject método en tiempo de ejecución, el sistema de configuración crea primero una instancia adecuada de la clase y, a continuación, devuelve el objeto que obtiene del método. GetSectionWhen 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.

De forma predeterminada GetRuntimeObject , simplemente devuelve el objeto que representa ConfigurationSection el desde el que se llama.By default, GetRuntimeObject simply returns the object that represents the ConfigurationSection from which it is called.

Notas a los desarrolladores de herederos

Puede invalidar el GetRuntimeObject() método para devolver un tipo personalizado en tiempo de ejecución.You can override the GetRuntimeObject() method to return a custom type at run time.

Por ejemplo, para restringir la modificación del tiempo de ejecución ConfigurationSection de la configuración de la GetRuntimeObject() clase, puede reemplazar y devolver un tipo personalizado que aplique restricciones en cuanto a la configuración que se puede modificar, si existe.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.

Si el objeto en tiempo de ejecución es solo interno, el objeto devuelto no se puede usar fuera del ensamblado que lo define.If the runtime object is internal only, the returned object cannot be used outside the assembly that defines it. Una manera de crear un objeto que se deriva de ConfigurationSection y a la que solo puede tener acceso el código del ensamblado en tiempo de ejecución es crear un objeto interno en tiempo de ejecución que tenga ConfigurationSection un método que devuelva la implementación.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.

Se aplica a