ConfigurationSection.GetRuntimeObject Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v11.0.0-preview.4.26230.115

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 montre comment utiliser la GetRuntimeObject méthode.

// 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 une instance appropriée de la ConfigurationSection classe, puis retourne l’objet qu’il obtient à partir de la GetRuntimeObject méthode.

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

Notes pour les héritiers

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

Par exemple, pour restreindre la modification du 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 pouvant ê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 et ConfigurationSection qui est accessible uniquement par du code dans votre assembly au moment de l’exécution consiste à créer un objet runtime interne qui a une méthode qui retourne votre ConfigurationSection implémentation.