ConfigurationSection.GetRuntimeObject Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationSection.cs

Retourne un objet personnalisé en cas de substitution dans une classe dérivée.

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

Retours

Object

Objet représentant la section.

Exemples

L'exemple suivant illustre l'utilisation de la méthode 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

Remarques

Lorsque la GetSection méthode est appelée au moment de l’exécution, le système de configuration crée d’abord un instance approprié de la ConfigurationSection classe, puis retourne l’objet qu’il obtient de la GetRuntimeObject méthode.

Par défaut, GetRuntimeObject retourne simplement l’objet qui représente le ConfigurationSection à partir duquel il est appelé.

Notes pour les héritiers

Vous pouvez remplacer la GetRuntimeObject() méthode pour retourner un type personnalisé au moment de l’exécution.

Par exemple, pour limiter la modification au runtime des paramètres de la ConfigurationSection classe, vous pouvez remplacer GetRuntimeObject() et retourner un type personnalisé qui applique des restrictions sur les paramètres qui peuvent être modifiés, le cas échéant.

Si l’objet runtime est interne uniquement, l’objet retourné ne peut pas être utilisé en dehors de l’assembly qui le définit. Une façon de créer un objet qui dérive de ConfigurationSection et n’est accessible que par le code de votre assembly au moment de l’exécution consiste à créer un objet runtime interne doté d’une méthode qui retourne votre ConfigurationSection implémentation.