Compartilhar via


Como: Acessar o modelo de objeto gerenciado do documento HTML

Você pode acessar o gerenciado HTML documento objeto DOM (modelo) entre dois tipos de aplicativos:

  • Um aplicativo Windows Forms (. exe) que coordenou a gerenciado WebBrowser de controle. Essas duas tecnologias complementam um ao outro, com o WebBrowser controle exibindo a página para o usuário e o DOM em HTML que representam estrutura lógica. do documento

  • Windows Forms UserControl hospedado no Internet Explorer. Você pode acessar o DOM em HTML que representa a página na qual seu 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 Windows Forms

  1. Host um WebBrowser de controle dentro de seu aplicativo Windows Forms e monitorar o DocumentCompleted evento. Para obter detalhes sobre a hospedagem de controles e monitoramento de eventos, consulte Consumindo Eventos.

  2. Recuperar o HtmlDocument para a página atual, acessando o Document propriedade da WebBrowser de controle.

Para acessar o DOM de um UserControl hospedado no Internet Explorer

  1. Criar sua própria classe derivada personalizada da UserControl classe. Para obter mais informações, consulte Como: Controles de composição do autor.

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

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
        HtmlDocument doc = null;

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

Programação robusta

  1. Ao usar o DOM através do WebBrowser controle, você deve sempre esperar até o DocumentCompleted evento ocorre antes de tentar acessar o Document propriedade da WebBrowser de controle. O DocumentCompleted evento é gerado após o carregamento do documento inteiro. Se você usar o DOM antes disso, você corre o risco de causar uma exceção de tempo de execução em seu aplicativo.

Segurança

  1. Seu aplicativo ou UserControl exigem confiança total para acessar o DOM de HTML gerenciado. Se você estiver implantando um aplicativo Windows Forms usando ClickOnce, você pode solicitar confiança total, usando a elevação de permissões ou de implantação de aplicativos confiáveis; consulte Protegendo <>>aplicativos ClickOnce para obter detalhes.

Consulte também

Outros recursos

Usando o modelo de objeto gerenciado do documento HTML