Como acessar o modelo de objeto de documento HTML gerenciado

Você pode acessar o DOM (Modelo de Objeto de Documento) HTML gerenciado de dois tipos de aplicativos:

• Um aplicativo do Windows Forms (.exe) que hospeda o controle gerenciado WebBrowser. Essas duas tecnologias se complementam, com o WebBrowser controle exibindo a página para o usuário e o DOM HTML que representa a estrutura lógica do documento.

• Um Windows Forms UserControl hospedado no Internet Explorer. Você pode acessar o HTML DOM que representa a página na qual UserControl está hospedado para alterar a estrutura do documento ou abrir caixas de diálogo modais, entre muitas outras possibilidades.

Para acessar o DOM de um aplicativo do Windows Forms

1. Hospede um WebBrowser controle em seu aplicativo do Windows Forms e monitore o evento DocumentCompleted. Para obter detalhes sobre controles de hospedagem e monitoramento de eventos, consulte Eventos.

2. Recupere HtmlDocument da página atual acessando a propriedade Document do controle WebBrowser.

Para acessar o DOM de um UserControl hospedado no Internet Explorer

1. Crie sua própria classe derivada personalizada da UserControl classe. Para obter mais informações, consulte Como criar controles compostos.

2. Coloque o seguinte código dentro do manipulador de eventos Load para o seu UserControl:

HtmlDocument doc = null;

private void UserControl1_Load(object sender, EventArgs e)
{
    if (this.Site != null)
    {
        doc = (HtmlDocument)this.Site.GetService(typeof(HtmlDocument));
    }
}

Private Sub UserControl1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    If (Me.Site IsNot Nothing) Then
        Dim Doc As HtmlDocument = CType(Me.Site.GetService(Type.GetType("System.Windows.Forms.HtmlDocument")), HtmlDocument)
    End If
End Sub

Programação robusta

1. Ao usar o DOM por meio do WebBrowser controle, você deve sempre aguardar até que o DocumentCompleted evento ocorra antes de tentar acessar a Document propriedade do WebBrowser controle. O DocumentCompleted evento é gerado após o carregamento de todo o documento; se você usar o DOM antes disso, corre o risco de causar uma exceção em tempo de execução em seu aplicativo.

Segurança do .NET Framework

1. Seu aplicativo ou UserControl exigirá total confiança para acessar o DOM HTML gerenciado. Se você estiver implantando um aplicativo do Windows Forms usando o ClickOnce, poderá solicitar confiança total usando a Elevação de Permissão ou a Implantação de Aplicativo Confiável; consulte Proteção de aplicativos ClickOnce para obter detalhes.

Consulte também

• usando o modelo de objeto de documento HTML gerenciado