Visão geral do controle WebBrowser
O controle WebBrowser fornece um wrapper gerenciado para o controle ActiveX do WebBrowser. O wrapper gerenciado permite exibir páginas da Web em seus aplicativos cliente do Windows Forms. Você pode usar o controle WebBrowser para duplicar a funcionalidade de navegação na Web do Internet Explorer em seu aplicativo ou desabilitar a funcionalidade padrão do Internet Explorer e usar o controle como um visualizador de documentos HTML simples. Você também pode usar o controle para adicionar elementos de interface do usuário baseados em DHTML ao seu formulário e ocultar o fato de que eles estão hospedados no controle WebBrowser. Essa abordagem permite combinar perfeitamente controles Web com controles do Windows Forms em um único aplicativo.
Propriedades, métodos e eventos usados com frequência
O controle WebBrowser tem várias propriedades, métodos e eventos que você pode usar para implementar controles encontrados no Internet Explorer. Por exemplo, você pode usar o método Navigate
para implementar uma barra de endereços e os métodos GoBack
, GoForward
, Stop
e Refresh
para implementar botões de navegação em uma barra de ferramentas. Você pode lidar com o evento Navigated
para atualizar a barra de endereços com o valor da propriedade Url
e a barra de título com o valor da propriedade DocumentTitle
.
Se você quiser gerar seu próprio conteúdo de página em seu aplicativo, poderá definir a propriedade DocumentText
. Se você estiver familiarizado com o DOM (modelo de objeto de documento HTML), também poderá manipular o conteúdo da página da Web atual por meio da propriedade Document
. Com essa propriedade, você pode armazenar e modificar documentos na memória em vez de navegar entre arquivos.
A propriedade Document
também permite que você chame os métodos implementados no código de script da página da Web do seu código de aplicativo cliente. Para acessar o código do aplicativo cliente a partir do código de script, defina a propriedade ObjectForScripting
. O objeto que você especificar pode ser acessado pelo código de script como o objeto window.external
.
Nome | Descrição |
---|---|
Propriedade Document | Obtém um objeto que fornece acesso gerenciado ao DOM (modelo de objeto de documento HTML) da página da Web atual. |
Evento DocumentCompleted | Ocorre quando uma página da Web termina de carregar. |
Propriedade DocumentText | Obtém ou define o conteúdo HTML da página da Web atual. |
Propriedade DocumentTitle | Obtém o título da página da Web atual. |
método GoBack | Navega para a página anterior no histórico. |
método GoForward | Navega para a próxima página no histórico. |
método Navigate | Navega até a URL especificada. |
Evento Navigating | Ocorre antes do início da navegação, permitindo que a ação seja cancelada. |
Propriedade ObjectForScripting | Obtém ou define um objeto que o código de script de página da Web pode usar para se comunicar com seu aplicativo. |
método Print | Imprime a página da Web atual. |
método Refresh | Recarrega a página da Web atual. |
método Stop | Interrompe a navegação atual e interrompe elementos dinâmicos da página, como sons e animação. |
Propriedade Url | Obtém ou define a URL da página da Web atual. Ajustar essa propriedade faz com que o controle navegue para o novo URL. |
Consulte também
- WebBrowser
- WebBrowserDocumentCompletedEventArgs
- WebBrowserDocumentCompletedEventHandler
- WebBrowserEncryptionLevel
- WebBrowserNavigatedEventArgs
- WebBrowserNavigatedEventHandler
- WebBrowserNavigatingEventArgs
- WebBrowserNavigatingEventHandler
- WebBrowserProgressChangedEventArgs
- WebBrowserReadyState
- WebBrowserRefreshOption
- Como navegar até uma URL com o controle WebBrowser
- Como imprimir com um controle WebBrowser
- Como adicionar recursos de navegador da Web a um aplicativo do Windows Forms
- Como criar um Visualizador de Documentos HTML em um aplicativo do Windows Forms
- Como implementar Two-Way comunicação entre código DHTML e código do aplicativo cliente
- Segurança do navegador
.NET Desktop feedback