ConfigurationSection.GetRuntimeObject Metoda

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

ConfigurationSection.cs

Zwraca obiekt niestandardowy po przesłonięciu w klasie pochodnej.

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

Zwraca

Object

Obiekt reprezentujący sekcję.

Przykłady

W poniższym przykładzie pokazano, jak używać GetRuntimeObject metody .

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

Uwagi

GetSection Gdy metoda jest wywoływana w czasie wykonywania, system konfiguracji najpierw tworzy odpowiednie wystąpienie ConfigurationSection klasy, a następnie zwraca obiekt, który uzyskuje z GetRuntimeObject metody .

Domyślnie GetRuntimeObject po prostu zwraca obiekt reprezentujący ConfigurationSection obiekt, z którego jest wywoływany.

Uwagi dotyczące dziedziczenia

Można zastąpić metodę GetRuntimeObject() , aby zwrócić typ niestandardowy w czasie wykonywania.

Aby na przykład ograniczyć modyfikację ustawień w środowisku uruchomieniowym w ConfigurationSection klasie, można zastąpić GetRuntimeObject() i zwrócić typ niestandardowy, który wymusza ograniczenia, które można modyfikować, jeśli istnieją.

Jeśli obiekt środowiska uruchomieniowego jest tylko wewnętrzny, zwracany obiekt nie może być używany poza zestawem, który go definiuje. Jednym ze sposobów utworzenia obiektu, który pochodzi z ConfigurationSection i może być dostępny tylko przez kod w zestawie w czasie wykonywania, jest utworzenie wewnętrznego obiektu środowiska uruchomieniowego, który ma metodę zwracającą ConfigurationSection implementację.