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

注釈

ときに、GetSectionメソッドは実行時に、構成システムは、最初の適切なインスタンスを作成、ConfigurationSectionクラス、およびから取得するオブジェクトを返します、GetRuntimeObjectメソッド。When 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. 派生したオブジェクトを作成する方法の 1 つ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.

適用対象