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

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

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

WebBrowser.DetachSink メソッド

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

基になる ActiveX コントロールの CreateSink メソッドでアタッチされたイベント処理クライアントを解放します。

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

Visual Basic (宣言)

Protected Overrides Sub
 DetachSink

Visual Basic (使用法)

Me.DetachSink

protected override void DetachSink ()

C++

protected:
virtual void DetachSink () override

protected void DetachSink ()

JScript

protected override function DetachSink ()

解説

アンマネージ WebBrowser ActiveX コントロールを使用した OLE 開発に慣れていれば、このメソッドを利用して Windows フォームの WebBrowser コントロールの機能を拡張できます。このコントロールは ActiveX コントロールのマネージラッパーです。この拡張性を利用して、ラッパーコントロールでは提供されない ActiveX コントロールのイベントを実装できます。

使用例

WebBrowser から派生したクラスでこのメソッドを使用し、標準の WebBrowser イベントを OLE DWebBrowserEvents2 の NavigateError イベントで補完する方法を次のコード例に示します。

コード全体については、「CreateSink」を参照してください。

Visual Basic

Private cookie As AxHost.ConnectionPointCookie
Private helper As WebBrowser2EventHelper

<PermissionSetAttribute(SecurityAction.LinkDemand, _
Name := "FullTrust")> Protected
 Overrides Sub CreateSink()

    MyBase.CreateSink()

    ' Create an instance of the client that will handle the event
    ' and associate it with the underlying ActiveX control.
    helper = New WebBrowser2EventHelper(Me)
    cookie = New AxHost.ConnectionPointCookie( _
        Me.ActiveXInstance, helper, GetType(DWebBrowserEvents2))
End Sub

<PermissionSetAttribute(SecurityAction.LinkDemand, _
Name := "FullTrust")> Protected Overrides Sub
 DetachSink()

    ' Disconnect the client that handles the event
    ' from the underlying ActiveX control.
    If cookie IsNot Nothing Then
        cookie.Disconnect()
        cookie = Nothing
    End If
    MyBase.DetachSink()

End Sub

AxHost.ConnectionPointCookie cookie;
WebBrowser2EventHelper helper;

[PermissionSetAttribute(SecurityAction.LinkDemand, Name="FullTrust")]
protected override void CreateSink()
{
    base.CreateSink();

    // Create an instance of the client that will handle the event
    // and associate it with the underlying ActiveX control.
    helper = new WebBrowser2EventHelper(this);
    cookie = new AxHost.ConnectionPointCookie(
        this.ActiveXInstance, helper, typeof(DWebBrowserEvents2));
}

[PermissionSetAttribute(SecurityAction.LinkDemand, Name="FullTrust")]
protected override void DetachSink()
{
    // Disconnect the client that handles the event
    // from the underlying ActiveX control.
    if (cookie != null)
    {
        cookie.Disconnect();
        cookie = null;
    }
    base.DetachSink();
}