ConfigurationSection.GetRuntimeObject Метод

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

ConfigurationSection.cs

Возвращает пользовательский объект при переопределении в производном классе.

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

Возвращаемое значение

Object

Объект, представляющий раздел.

Примеры

В следующем примере показано, как использовать метод 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

Комментарии

При вызове GetSection метода во время выполнения система конфигурации сначала создает соответствующий ConfigurationSection экземпляр класса , а затем возвращает объект, полученный из GetRuntimeObject метода .

По умолчанию просто возвращает объект , представляющий ConfigurationSection объект , GetRuntimeObject из которого он вызывается.

Примечания для тех, кто наследует этот метод

Вы можете переопределить GetRuntimeObject() метод , чтобы вернуть пользовательский тип во время выполнения.

Например, чтобы ограничить изменение параметров в ConfigurationSection классе во время выполнения, можно переопределить GetRuntimeObject() и вернуть пользовательский тип, который применяет ограничения, на которые можно изменить параметры, если таковые есть.

Если объект среды выполнения является внутренним, возвращаемый объект нельзя использовать за пределами сборки, которая его определяет. Один из способов создания объекта, производного от ConfigurationSection и доступ к которому может получить только код в сборке во время выполнения, заключается в создании внутреннего объекта среды выполнения с методом, возвращающим реализацию ConfigurationSection .