ToolStripControlHost.OnUnsubscribeControlEvents メソッド

.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)

C#

protected virtual void OnUnsubscribeControlEvents
 (
    Control control
)

C++

protected:
virtual void OnUnsubscribeControlEvents (
    Control^ control
)

J#

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

C#

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);
}

プラットフォーム

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

参照

関連項目
ToolStripControlHost クラス
ToolStripControlHost メンバ
System.Windows.Forms 名前空間