ComponentEventHandler デリゲート

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

ComponentEventHandler デリゲート

コンポーネント レベルのイベントに対して発生する ComponentAdding、ComponentAdded、ComponentRemoving、ComponentRemoved の各イベントを処理するメソッドを表します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Delegate Sub ComponentEventHandler
 ( _
    sender As Object, _
    e As ComponentEventArgs _
)

Visual Basic (使用法)

Dim instance As New ComponentEventHandler(AddressOf
 HandlerMethod)

C#

[ComVisibleAttribute(true)] 
public delegate void ComponentEventHandler
 (
    Object sender,
    ComponentEventArgs e
)

C++

[ComVisibleAttribute(true)] 
public delegate void ComponentEventHandler
 (
    Object^ sender, 
    ComponentEventArgs^ e
)

J#

/** @delegate */
/** @attribute ComVisibleAttribute(true) */ 
public delegate void ComponentEventHandler
 (
    Object sender, 
    ComponentEventArgs e
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

sender

イベントのソース。

e

イベント データを格納している ComponentEventArgs。

解説

ComponentEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを識別してください。イベントをイベント ハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベント ハンドラが呼び出されます。イベント ハンドラ デリゲートの詳細については、「イベントとデリゲート」を参照してください。

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

使用例

ComponentEventHandler の登録と ComponentAdded、ComponentAdding、ComponentRemoved、および ComponentRemoving の各イベントの処理の例を次に示します。

Visual Basic

Public Sub LinkComponentEvent(ByVal
 changeService As IComponentChangeService)
    ' Registers an event handler for the ComponentAdded,
    ' ComponentAdding, ComponentRemoved, and ComponentRemoving events.
    AddHandler changeService.ComponentAdded, AddressOf
 Me.OnComponentEvent
    AddHandler changeService.ComponentAdding, AddressOf
 Me.OnComponentEvent
    AddHandler changeService.ComponentRemoved, AddressOf
 Me.OnComponentEvent
    AddHandler changeService.ComponentRemoving, AddressOf
 Me.OnComponentEvent
End Sub

Private Sub OnComponentEvent(ByVal
 sender As Object, ByVal
 e As ComponentEventArgs)
    ' Displays changed component information on the console.       
     
    If Not (e.Component.Site Is
 Nothing) Then
        Console.WriteLine(("Name of the component related to the
 event: " + e.Component.Site.Name))
    End If
End Sub

C#

public void LinkComponentEvent(IComponentChangeService
 changeService)
{
    // Registers an event handler for the ComponentAdded,
    // ComponentAdding, ComponentRemoved, and ComponentRemoving events.
    changeService.ComponentAdded += new ComponentEventHandler(this.OnComponentEvent);
            
    changeService.ComponentAdding += new ComponentEventHandler(this.OnComponentEvent);
            
    changeService.ComponentRemoved += new ComponentEventHandler(this.OnComponentEvent);
            
    changeService.ComponentRemoving += new ComponentEventHandler(this.OnComponentEvent);
                        
}

private void OnComponentEvent(object sender,
 ComponentEventArgs e)
{
    // Displays changed component information on the console.      
      
    if( e.Component.Site != null )
        Console.WriteLine("Name of the component related to the event: "+e.Component.Site.Name);
      
    Console.WriteLine("Type of the component related to the event: "+e.Component.GetType().FullName);
}

C++

public:
   void LinkComponentEvent( IComponentChangeService^ changeService
 )
   {
      // Registers an event handler for the ComponentAdded,
      // ComponentAdding, ComponentRemoved, and ComponentRemoving events.
      changeService->ComponentAdded += gcnew ComponentEventHandler(
         this, &ComponentEventHandlerExample::OnComponentEvent
 );
      changeService->ComponentAdding += gcnew ComponentEventHandler(
         this, &ComponentEventHandlerExample::OnComponentEvent
 );
      changeService->ComponentRemoved += gcnew ComponentEventHandler(
         this, &ComponentEventHandlerExample::OnComponentEvent
 );
      changeService->ComponentRemoving += gcnew ComponentEventHandler(
         this, &ComponentEventHandlerExample::OnComponentEvent
 );
   }

private:
   void OnComponentEvent( Object^ sender, ComponentEventArgs^
 e )
   {
      // Displays changed component information on the console.
      if ( e->Component->Site != nullptr )
      {
         Console::WriteLine( "Name of the component related to the event: "
 +
            e->Component->Site->Name );
      }
      Console::WriteLine( "Type of the component related to the event: "
 +
         e->Component->GetType()->FullName );
   }

J#

public void LinkComponentEvent(IComponentChangeService
 changeService)
{
    // Registers an event handler for the ComponentAdded,
    // ComponentAdding, ComponentRemoved, and ComponentRemoving events.
    changeService.add_ComponentAdded(new ComponentEventHandler(this.
        OnComponentEvent));
    changeService.add_ComponentAdding(new ComponentEventHandler(this.
        OnComponentEvent));
    changeService.add_ComponentRemoved(new ComponentEventHandler(this.
        OnComponentEvent));
    changeService.add_ComponentRemoving(new ComponentEventHandler(this.
        OnComponentEvent));
} //LinkComponentEvent

private void OnComponentEvent(Object sender,
 ComponentEventArgs e)
{
    // Displays changed component information on the console.      
      
    if (e.get_Component().get_Site() != null)
 {
        Console.WriteLine("Name of the component related to the event: "
            + e.get_Component().get_Site().get_Name());
    }
    Console.WriteLine("Type of the component related to the event: "
        + e.get_Component().GetType().get_FullName());
} //OnComponentEvent

プラットフォーム

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

参照

関連項目
System.ComponentModel.Design 名前空間
ComponentEventArgs クラス
ComponentChangingEventHandler デリゲート
ComponentChangedEventHandler デリゲート