ConfigurationSection.GetRuntimeObject Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ConfigurationSection.cs

Gibt ein benutzerdefiniertes Objekt zurück, wenn es in einer abgeleiteten Klasse überschrieben wird.

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

Gibt zurück

Object

Das Objekt, das den Abschnitt darstellt.

Beispiele

Im folgenden Beispiel wird die Verwendung der GetRuntimeObject-Methode gezeigt.

// 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

Hinweise

Wenn die GetSection -Methode zur Laufzeit aufgerufen wird, erstellt das Konfigurationssystem zunächst eine entsprechende instance der ConfigurationSection -Klasse und gibt dann das Objekt zurück, das es von der GetRuntimeObject -Methode erhält.

Standardmäßig gibt einfach das -Objekt zurück, GetRuntimeObject das das ConfigurationSection darstellt, von dem es aufgerufen wird.

Hinweise für Vererber

Sie können die GetRuntimeObject() Methode überschreiben, um zur Laufzeit einen benutzerdefinierten Typ zurückzugeben.

Um beispielsweise die Laufzeitänderung der Einstellungen in der ConfigurationSection -Klasse einzuschränken, können Sie einen benutzerdefinierten Typ überschreiben GetRuntimeObject() und zurückgeben, der Einschränkungen erzwingt, für die Einstellungen geändert werden können, falls vorhanden.

Wenn das Laufzeitobjekt nur intern ist, kann das zurückgegebene Objekt nicht außerhalb der Assembly verwendet werden, die es definiert. Eine Möglichkeit zum Erstellen eines Objekts, das von ConfigurationSection abgeleitet wird und nur von Code in Der Assembly zur Laufzeit zugegriffen werden kann, besteht darin, ein internes Laufzeitobjekt zu erstellen, das über eine Methode verfügt, die Ihre ConfigurationSection Implementierung zurückgibt.