ComponentChangingEventArgs クラス

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

ComponentChangingEventArgs クラス

ComponentChanging イベントのデータを提供します。このクラスは継承できません。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public NotInheritable Class
 ComponentChangingEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As ComponentChangingEventArgs

C#

[ComVisibleAttribute(true)] 
public sealed class ComponentChangingEventArgs
 : EventArgs

C++

[ComVisibleAttribute(true)] 
public ref class ComponentChangingEventArgs
 sealed : public EventArgs

J#

/** @attribute ComVisibleAttribute(true) */ 
public final class ComponentChangingEventArgs
 extends EventArgs

JScript

ComVisibleAttribute(true) 
public final class ComponentChangingEventArgs
 extends EventArgs

解説

ComponentChangingEventArgs は、ComponentChanging イベントに関するデータを提供します。ComponentChanging イベントは、IComponentChangeService および登録されているイベント ハンドラに対して、現在のデザイン ドキュメント内の特定のコンポーネントが変更されようとしていることを通知します。このイベントにより、さまざまな状況で、コンポーネントが変更されることを回避できます。

ComponentChanging イベントは、コンポーネントが変更される前に発生します。このイベントを発生させることで、デザイナで変更を中止する機会を作ることができます。通常、コンポーネント デザイナは ComponentChanging イベントを自動的に発生させます。プロパティを変更できない場合、このイベントを処理するメソッドは例外をスローすることがあります。たとえば、デザイナ ファイルがソース コード管理にチェックインされていて、ユーザーがそのファイルのチェックアウトを拒否している場合、このイベントのハンドラは例外をスローします。

ComponentChangingEventArgs は、次の情報を提供します。

• 変更されようとしているコンポーネントを示す Component プロパティ。

• 変更されようとしているメンバを示す Member プロパティ。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

継承時の注意 このクラスが別のクラスの基本クラスとして指定されると、コンパイラ エラーが発生します。

使用例

ComponentChangingEventArgs を作成する例を次に示します。

Visual Basic

' This example method creates a ComponentChangingEventArgs using the
 specified arguments.
' Typically, this type of event args is created by a design mode subsystem.
  
Public Function CreateComponentChangingEventArgs(ByVal
 component As Object, ByVal
 member As MemberDescriptor) As ComponentChangingEventArgs
    Dim args As New ComponentChangingEventArgs(component,
 member)

    ' The component that is about to change:       args.Component
    ' The member that is about to change:          args.Member

    Return args
End Function

C#

// This example method creates a ComponentChangingEventArgs using the
 specified arguments.
// Typically, this type of event args is created by a design mode subsystem.
  
public ComponentChangingEventArgs CreateComponentChangingEventArgs(object
 component, MemberDescriptor member)
{
    ComponentChangingEventArgs args = new ComponentChangingEventArgs(component,
 member);

    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member

    return args;
}

C++

public:
   // This example method creates a ComponentChangingEventArgs using the
 specified arguments.
   // Typically, this type of event args is created by a design mode
 subsystem.
   ComponentChangingEventArgs^ CreateComponentChangingEventArgs( Object^ component,
 MemberDescriptor^ member )
   {
      // The component that is about to change:       args.Component
      // The member that is about to change:          args.Member
      return gcnew ComponentChangingEventArgs( component,member
 );
   }

J#

// This example method creates a ComponentChangingEventArgs
// using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.
public ComponentChangingEventArgs CreateComponentChangingEventArgs(
    Object component, MemberDescriptor member)
{
    ComponentChangingEventArgs args = new 
        ComponentChangingEventArgs(component, member);
    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member
    return args;
} //CreateComponentChangingEventArgs

継承階層

System.Object
   System.EventArgs
    System.ComponentModel.Design.ComponentChangingEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
ComponentChangingEventArgs メンバ
System.ComponentModel.Design 名前空間
ComponentChanging
ComponentChanged
ComponentChangingEventHandler
IComponentChangeService