ConfigurationSection.GetRuntimeObject ConfigurationSection.GetRuntimeObject ConfigurationSection.GetRuntimeObject ConfigurationSection.GetRuntimeObject Method

Определение

Возвращает пользовательский объект при переопределении в производном классе.Returns a custom object when overridden in a derived class.

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

Возвраты

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

Примеры

В следующем примере показано, как использовать метод GetRuntimeObject.The following example shows how to use the GetRuntimeObject method.

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

Комментарии

Когда метод вызывается во время выполнения, система конфигурации сначала создает соответствующий экземпляр ConfigurationSection класса, а затем возвращает объект, который GetRuntimeObject он получает из метода. GetSectionWhen the GetSection method is called at run time, the configuration system first creates an appropriate instance of the ConfigurationSection class, and then returns the object it obtains from the GetRuntimeObject method.

По умолчанию GetRuntimeObject просто возвращает объект, представляющий, ConfigurationSection из которого он вызывается.By default, GetRuntimeObject simply returns the object that represents the ConfigurationSection from which it is called.

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

Можно переопределить метод, GetRuntimeObject() чтобы он возвращал пользовательский тип во время выполнения.You can override the GetRuntimeObject() method to return a custom type at run time.

Например, чтобы ограничить изменение параметров во время выполнения в ConfigurationSection классе, можно переопределить GetRuntimeObject() и вернуть пользовательский тип, обеспечивающий ограничения на то, какие параметры могут быть изменены, если таковые имеются.For example, to restrict runtime modification of the settings in the ConfigurationSection class, you can override GetRuntimeObject() and return a custom type that enforces restrictions on which settings can be modified, if any.

Если объект среды выполнения является только внутренним, возвращаемый объект не может использоваться за пределами сборки, в которой он определен.If the runtime object is internal only, the returned object cannot be used outside the assembly that defines it. Один из способов создания объекта, который является производным ConfigurationSection от и доступен только для кода в сборке во время выполнения, — это создание внутреннего объекта среды выполнения, который содержит метод, ConfigurationSection возвращающий реализацию.One way to create an object that derives from ConfigurationSection and can only be accessed by code in your assembly at run time is to create an internal runtime object that has a method that returns your ConfigurationSection implementation.

Применяется к