WebBrowser.DetachSink Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.