IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
特定のコンポーネントが変更されていることをコンポーネント変更サービスにアナウンスします。
public:
void OnComponentChanging(System::Object ^ component, System::ComponentModel::MemberDescriptor ^ member);
public void OnComponentChanging(object component, System.ComponentModel.MemberDescriptor member);
abstract member OnComponentChanging : obj * System.ComponentModel.MemberDescriptor -> unit
Public Sub OnComponentChanging (component As Object, member As MemberDescriptor)
パラメーター
- component
- Object
変更しようとしているコンポーネント。
- member
- MemberDescriptor
変更中のメンバー。 これは、この変更が 1 つのメンバーに関連していない場合に null されます。
注釈
このメソッドは、 ComponentChanging イベントを発生させます。
Windows SDK とVisual Studioデザイン時環境に含まれるほとんどのデザイナーは、通常、このイベントを自動的に発生させます。そのため、ほとんどの場合、このメソッドを明示的に呼び出す必要はありません。 適切な IComponentChangeService イベントは、プロパティ値の変更に PropertyDescriptor が使用されるか、コンポーネントが IDesignerHost コンテナーに追加または削除されたときに自動的に発生します。
注意 (実装者)
プロパティを変更できない場合、このメソッドは例外をスローします。 これは、特定のプロパティの値を検証するためのものではありません。 代わりに、コンポーネントが変更されないようにするグローバルな方法を提供することを目的としています。 たとえば、デザイナー ファイルがソース コード管理にチェックインされている場合、ユーザーがファイルのチェックアウトを拒否した場合、このイベントのハンドラーは通常、例外をスローします。