ToolStripControlHost.OnUnsubscribeControlEvents メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ToolStripControlHost.OnUnsubscribeControlEvents メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ホストされるコントロールからのイベントをアンサブスクライブします。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 OnUnsubscribeControlEvents ( _
    control As Control _
)

Visual Basic (使用法)

Dim control As Control

Me.OnUnsubscribeControlEvents(control)

protected virtual void OnUnsubscribeControlEvents
 (
    Control control
)

C++

protected:
virtual void OnUnsubscribeControlEvents (
    Control^ control
)

protected void OnUnsubscribeControlEvents (
    Control control
)

JScript

protected function OnUnsubscribeControlEvents
 (
    control : Control
)

パラメータ

control: イベントをアンサブスクライブするコントロール。

解説

OnUnSubscribeControlEvents メソッドをオーバーライドすることにより、OnSubscribeControlEvents でサブスクライブされたイベントをアンサブスクライブできます。

イベントが発生すると、デリゲートを使用してイベントハンドラが呼び出されます。詳細については、「イベントの発生」を参照してください。

OnUnsubscribeControlEvents メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

継承時の注意 派生クラスで OnUnsubscribeControlEvents をオーバーライドする場合は、登録されているデリゲートがイベントを受け取ることができるように、基本クラスの OnUnsubscribeControlEvents メソッドを呼び出してください。

使用例

ホストされるコントロールが公開するイベントをアンサブスクライブする方法を次のコード例に示します。このコード例は、ToolStripControlHost クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Protected Overrides Sub
 OnUnsubscribeControlEvents(ByVal c As Control)
    ' Call the base method so the basic events are unsubscribed.
    MyBase.OnUnsubscribeControlEvents(c)

    ' Cast the control to a MonthCalendar control.
    Dim monthCalendarControl As MonthCalendar
 = _
        CType(c, MonthCalendar)

    ' Remove the event.
    RemoveHandler monthCalendarControl.DateChanged, _
        AddressOf HandleDateChanged

End Sub

protected override void OnUnsubscribeControlEvents(Control
 c)
{
    // Call the base method so the basic events are unsubscribed.
    base.OnUnsubscribeControlEvents(c);

    // Cast the control to a MonthCalendar control.
    MonthCalendar monthCalendarControl = (MonthCalendar) c;

    // Remove the event.
    monthCalendarControl.DateChanged -=
        new DateRangeEventHandler(OnDateChanged);
}