Visão geral do controle WebBrowserWebBrowser Control Overview

O WebBrowser controle fornece um wrapper gerenciado para o controle WebBrowser ActiveX.The WebBrowser control provides a managed wrapper for the WebBrowser ActiveX control. O wrapper gerenciado permite exibir páginas da Web em seus aplicativos cliente dos Windows Forms.The managed wrapper lets you display Web pages in your Windows Forms client applications. Você pode usar o WebBrowser controle para duplicar a funcionalidade de navegação da Web Internet Explorer em seu aplicativo, ou você pode desabilitar a funcionalidade padrão do Internet Explorer e usar o controle como um visualizador de documentos HTML simple.You can use the WebBrowser control to duplicate Internet Explorer Web browsing functionality in your application or you can disable default Internet Explorer functionality and use the control as a simple HTML document viewer. Você também pode usar o controle para adicionar elementos da interface do usuário com base em DHTML ao seu formulário e ocultar o fato de que eles são hospedados no WebBrowser controle.You can also use the control to add DHTML-based user interface elements to your form and hide the fact that they are hosted in the WebBrowser control. Essa abordagem permite combinar perfeitamente controles Web com controles dos Windows Forms em um único aplicativo.This approach lets you seamlessly combine Web controls with Windows Forms controls in a single application.

Propriedades, métodos e eventos usados com frequênciaFrequently Used Properties, Methods, and Events

O WebBrowser controle tem várias propriedades, métodos e eventos que você pode usar para implementar controles encontrados no Internet Explorer.The WebBrowser control has several properties, methods, and events that you can use to implement controls found in 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 os botões de navegação em uma barra de ferramentas.For example, you can use the Navigate method to implement an address bar, and the GoBack, GoForward, Stop, and Refresh methods to implement navigation buttons on a toolbar. Você pode manipular 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.You can handle the Navigated event to update the address bar with the value of the Url property and the title bar with the value of the DocumentTitle property.

Se você quiser gerar seu próprio conteúdo de página dentro de seu aplicativo, defina a propriedade DocumentText.If you want to generate your own page content within your application, you can set the DocumentText property. Se você estiver familiarizado com o DOM (Modelo de Objeto do Documento) HTML, também poderá manipular o conteúdo da página da Web por meio da propriedade Document.If you are familiar with the HTML document object model (DOM), you can also manipulate the contents of the current Web page through the Document property. Com essa propriedade, você pode armazenar e modificar documentos na memória, em vez de navegar entre arquivos.With this property, you can store and modify documents in memory instead of navigating among files.

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.The Document property also lets you call methods implemented in Web page scripting code from your client application code. Para acessar o código do aplicativo cliente do seu código de script, defina a propriedade ObjectForScripting.To access your client application code from your scripting code, set the ObjectForScripting property. O objeto especificado pode ser acessado pelo seu código de script como o objeto window.external.The object that you specify can be accessed by your script code as the window.external object.

NomeName DescriçãoDescription
Propriedade DocumentDocument property Obtém um objeto que fornece acesso gerenciado para DOM (Modelo de Objeto do Documento) HTML da página da Web atual.Gets an object that provides managed access to the HTML document object model (DOM) of the current Web page.
Evento DocumentCompletedDocumentCompleted event Ocorre quando uma página da Web conclui o carregamento.Occurs when a Web page finishes loading.
Propriedade DocumentTextDocumentText property Obtém ou define o conteúdo HTML da página da Web atual.Gets or sets the HTML content of the current Web page.
Propriedade DocumentTitleDocumentTitle property Obtém o título da página da Web atual.Gets the title of the current Web page.
Método GoBackGoBack method Navega para a página anterior no histórico.Navigates to the previous page in history.
Método GoForwardGoForward method Navega para a próxima página no histórico.Navigates to the next page in history.
Método NavigateNavigate method Navega para a URL especificada.Navigates to the specified URL.
Evento NavigatingNavigating event Ocorre antes do início de navegação, permitindo que a ação seja cancelada.Occurs before navigation begins, enabling the action to be canceled.
Propriedade ObjectForScriptingObjectForScripting property Obtém ou define um objeto que o código de script da página da Web pode usar para se comunicar com o aplicativo.Gets or sets an object that Web page scripting code can use to communicate with your application.
Método PrintPrint method Imprime a página da Web atual.Prints the current Web page.
Método RefreshRefresh method Recarrega a página da Web atual.Reloads the current Web page.
Método StopStop method Interrompe a navegação atual e para elementos de página dinâmicos, como sons e animação.Halts the current navigation and stops dynamic page elements such as sounds and animation.
Propriedade UrlUrl property Obtém ou define a URL da página da Web atual.Gets or sets the URL of the current Web page. Configurar essa propriedade leva o controle para a nova URL.Setting this property navigates the control to the new URL.

Consulte tambémSee also