Información general sobre el control WebBrowser
Actualización: noviembre 2007
El control WebBrowser proporciona un contenedor administrado para el control ActiveX WebBrowser. El contenedor administrado permite mostrar páginas Web en las aplicaciones cliente de los formularios Windows Forms. Se puede utilizar el control WebBrowser para duplicar la funcionalidad de exploración Web de Internet Explorer en la aplicación o se puede deshabilitar la funcionalidad predeterminada de Internet Explorer y utilizar el control como visor simple de documentos HTML. También se puede utilizar el control para agregar elementos de la interfaz de usuario basados en DHTML al formulario y no mostrar el hecho de que se alojan en el control WebBrowser. Este enfoque permite combinar sin problemas controles Web con controles de formularios Windows Forms en una sola aplicación.
Propiedades, métodos y eventos de uso frecuente
El control WebBrowser tiene varias propiedades, métodos y eventos que se pueden utilizar para implementar controles de Internet Explorer. Por ejemplo, se puede utilizar el método Navigate para implementar una barra de direcciones y los métodos GoBack, GoForward, Stop y Refresh para implementar botones de exploración en una barra de herramientas. Se puede controlar el evento Navigated para actualizar la barra de direcciones con el valor de la propiedad Url y la barra de título con el valor de la propiedad DocumentTitle.
Si se desea generar el contenido de la página propia en la aplicación, se puede establecer la propiedad DocumentText. Si se está familiarizado con el modelo de objetos de documento (DOM) HTML, también se puede manipular el contenido de la página Web actual mediante la propiedad Document. Con esta propiedad, puede almacenar y modificar documentos en memoria en lugar de desplazarse entre los archivos.
La propiedad Document también permite llamar a métodos implementados en código de secuencia de comandos de páginas Web desde el código de la aplicación cliente. Para tener acceso al código de la aplicación cliente desde el código de secuencia de comandos, se ha de establecer la propiedad ObjectForScripting. El objeto que se especifica es accesible para el código de secuencia de comandos como el objeto window.external.
Nombre |
Descripción |
|---|---|
Propiedad Document |
Obtiene un objeto que proporciona acceso administrado al modelo de objetos de documento (DOM) HTML de la página Web actual. |
DocumentCompleted (evento) |
Se produce cuando finaliza la carga de una página Web. |
Propiedad DocumentText |
Obtiene o establece el contenido HTML de la página Web actual. |
Propiedad DocumentTitle |
Obtiene el título de la página Web actual. |
Método GoBack |
Se desplaza a la página anterior del historial. |
Método GoForward |
Se desplaza a la página siguiente del historial. |
Método Navigate |
Se desplaza a la dirección URL especificada. |
Navigating (evento) |
Se produce antes de que empiece la exploración, lo que permite cancelar la acción. |
Propiedad ObjectForScripting |
Obtiene o establece un objeto que el código de secuencia de comandos de páginas Web puede utilizar para comunicarse con la aplicación. |
Método Print |
Imprime la página Web actual. |
Método Refresh |
Vuelve a cargar la página Web actual. |
Método Stop |
Detiene la exploración actual y los elementos de páginas dinámicas tales como sonidos y animación. |
Propiedad Url |
Obtiene o establece la dirección URL de la página Web actual. Al establecer esta propiedad, el control se desplaza a la nueva dirección URL. |
Vea también
Tareas
Cómo: Desplazarse a una dirección URL con el control WebBrowser
Cómo: Imprimir con un control WebBrowser
Cómo: Agregar funciones de explorador Web a una aplicación de Windows Forms
Cómo: Crear un visor de documentos HTML en una aplicación de Windows Forms
Cómo: Implementar la comunicación bidireccional entre código DHTML y código de la aplicación cliente
Conceptos
Referencia
WebBrowserDocumentCompletedEventArgs
WebBrowserDocumentCompletedEventHandler
WebBrowserNavigatedEventHandler
WebBrowserNavigatingEventHandler