PropertyDescriptor.SetValue メソッド

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

PropertyDescriptor.SetValue メソッド

派生クラスでオーバーライドされた場合、コンポーネントの値を別の値に設定します。

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

Visual Basic (宣言)

Public MustOverride Sub
 SetValue ( _
    component As Object, _
    value As Object _
)

Visual Basic (使用法)

Dim instance As PropertyDescriptor
Dim component As Object
Dim value As Object

instance.SetValue(component, value)

C#

public abstract void SetValue (
    Object component,
    Object value
)

C++

public:
virtual void SetValue (
    Object^ component, 
    Object^ value
) abstract

J#

public abstract void SetValue (
    Object component, 
    Object value
)

JScript

public abstract function SetValue (
    component : Object, 
    value : Object
)

パラメータ

component

設定する対象のプロパティ値を持つコンポーネント。

value

新しい値。

解説

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

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

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

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

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

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

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

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

継承時の注意 オーバーライドされた場合、このメソッドは、実装する必要がある "SetMyProperty" メソッドを呼び出すことによってプロパティの値を設定します。指定した値が無効な場合、コンポーネントは例外をスローし、その例外は派生元にも渡されます。"SetMyProperty" メソッドに続く (実装した) "GetMyProperty" メソッドが、"SetMyProperty" メソッドによって例外がスローされなかった場合に渡された値を返すように、プロパティをデザインする必要があります。

プラットフォーム

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 クラス