ConfigurationSection.GetRuntimeObject Methode

Definition

Namespace:
System.Configuration
Assembly:
System.Configuration.dll

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

Das folgende Beispiel zeigt, wie die GetRuntimeObject Methode verwendet wird.

// 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 Methode zur Laufzeit aufgerufen wird, erstellt das GetSection Konfigurationssystem zunächst eine entsprechende Instanz der ConfigurationSection Klasse und gibt dann das Objekt zurück, das sie von der GetRuntimeObject Methode abruft.

Gibt standardmäßig einfach das Objekt zurück, GetRuntimeObject das das ConfigurationSection aufgerufene Objekt darstellt.

Hinweise für Vererber

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

Wenn Sie z. B. die Laufzeitänderung der Einstellungen in der ConfigurationSection Klasse einschränken möchten, können Sie einen benutzerdefinierten Typ überschreiben GetRuntimeObject() und zurückgeben, der einschränkungen erzwingt, welche Einstellungen ggf. geändert werden können.

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 code in Ihrer Assembly zur Laufzeit abgeleitet wird und nur darauf zugegriffen werden kann, besteht darin, ein internes Laufzeitobjekt mit einer Methode zu erstellen, die Ihre ConfigurationSection Implementierung zurückgibt.

Gilt für: