WebBrowser.DetachSink Método

Definição

Liberta o cliente de gestão de eventos associado ao CreateSink() método do controlo ActiveX subjacente.

protected:
 override void DetachSink();
protected override void DetachSink();
override this.DetachSink : unit -> unit
Protected Overrides Sub DetachSink ()

Exemplos

O seguinte exemplo de código ilustra a utilização deste método numa classe derivada de WebBrowser que complementa os eventos padrão WebBrowser com o NavigateError evento da interface OLE DWebBrowserEvents2 .

Para o exemplo completo do código, veja CreateSink.

AxHost.ConnectionPointCookie cookie;
WebBrowser2EventHelper helper;

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

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

Observações

Este método é útil se estiver familiarizado com o desenvolvimento OLE usando o controlo não gerido WebBrowser ActiveX e quiser expandir a funcionalidade do controlo Windows Forms WebBrowser, que é um wrapper gerido para o controlo ActiveX. Pode usar esta extensibilidade para implementar eventos do controlo ActiveX que não são fornecidos pelo controlo do wrapper.

Aplica-se a

Ver também