ConfigurationSection.GetRuntimeObject Метод

Определение

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

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

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

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

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 метода.

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

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

Метод можно переопределить GetRuntimeObject() для возврата пользовательского типа во время выполнения.

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

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