PropertyDescriptor.ResetValue メソッド

.NET Framework クラス ライブラリ リファレンス

PropertyDescriptor.ResetValue メソッド

派生クラスでオーバーライドされた場合、コンポーネントのプロパティの値を既定値にリセットします。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Sub
 ResetValue ( _
    component As Object _
)

Visual Basic (使用法)

Dim instance As PropertyDescriptor
Dim component As Object

instance.ResetValue(component)

C#

public abstract void ResetValue (
    Object component
)

C++

public:
virtual void ResetValue (
    Object^ component
) abstract

J#

public abstract void ResetValue (
    Object component
)

JScript

public abstract function ResetValue (
    component : Object
)

パラメータ

component

既定値にリセットする対象のプロパティ値を持つコンポーネント。

解説

通常、このメソッドはリフレクションによって実装されます。

このメソッドは、次の優先順位に従って、プロパティがリセットされる既定値を決定します。

1. プロパティのシャドウ プロパティがある。

2. プロパティの DefaultValueAttribute がある。

3. "ResetMyProperty" メソッドが実装されている。"MyProperty" は、渡したプロパティの名前です。

このメソッドは、次の順序に従って、自動的に DesignerTransaction を作成します。

1. このメソッドでは、IDesignerHost.CreateTransaction メソッドを呼び出し、変更部分を表す新しい DesignerTransaction を作成します。

2. このメソッドは、トランザクションが開始され、これから変更が行われることを示す IComponentChangeService.OnComponentChanging メソッドを呼び出します。

3. メソッド独自のチェック順序に従って決定された値にプロパティをリセットします。

4. このメソッドは、変更が行われたことを示す IComponentChangeService.OnComponentChanged メソッドを呼び出します。

5. トランザクションが完了したことを示す DesignerTransaction.Commit を呼び出します。

トランザクションの目的は、Undo 機能と Redo 機能をサポートすることです。

継承時の注意 派生クラスでオーバーライドされた場合、このメソッドは DefaultValueAttribute を検索します。この属性が見つかった場合、見つかった DefaultValueAttribute をプロパティの値として設定します。DefaultValueAttribute が見つからなかった場合、このメソッドは、実装する必要がある "ResetMyProperty" メソッドを検索します。見つかった場合は、ResetValue メソッドによって呼び出されます。ResetValue で、実装した DefaultValueAttribute や "ResetMyProperty" メソッドが見つからない場合、処理が実行されません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
PropertyDescriptor クラス
PropertyDescriptor メンバ
System.ComponentModel 名前空間
PropertyDescriptor クラス