ConfigurationSection.GetRuntimeObject ConfigurationSection.GetRuntimeObject ConfigurationSection.GetRuntimeObject ConfigurationSection.GetRuntimeObject Method

Definizione

Restituisce un oggetto personalizzato quando ne viene eseguito l'override in una classe derivata.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

Restituisce

Oggetto che rappresenta la sezione.The object representing the section.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il metodo 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

Commenti

Quando la GetSection viene chiamato in fase di esecuzione, il sistema di configurazione crea innanzitutto un'istanza appropriata del ConfigurationSection classe e quindi restituisce l'oggetto ottenuto dal GetRuntimeObject (metodo).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.

Per impostazione predefinita GetRuntimeObject restituisce semplicemente l'oggetto che rappresenta il ConfigurationSection dal quale viene chiamato.By default, GetRuntimeObject simply returns the object that represents the ConfigurationSection from which it is called.

Note per gli eredi

È possibile eseguire l'override di GetRuntimeObject() per restituire un tipo personalizzato in fase di esecuzione.You can override the GetRuntimeObject() method to return a custom type at run time.

Ad esempio, per limitare la modifica di runtime delle impostazioni di ConfigurationSection (classe), è possibile eseguire l'override GetRuntimeObject() e restituire un tipo personalizzato che applica restrizioni su cui è possibile modificare le impostazioni, se presente.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 l'oggetto runtime è solo interno, l'oggetto restituito non può essere utilizzato all'esterno dell'assembly che lo definisce.If the runtime object is internal only, the returned object cannot be used outside the assembly that defines it. Un modo per creare un oggetto che deriva da ConfigurationSection e sono accessibili solo dal codice nell'assembly in fase di esecuzione fase consiste nel creare un oggetto di runtime interno che ha un metodo che restituisce il ConfigurationSection implementazione.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.

Si applica a