¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

WebBrowser (Clase)

Permite que el usuario explore las páginas Web del formulario.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
[ComVisibleAttribute(true)] 
public class WebBrowser : WebBrowserBase
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class WebBrowser extends WebBrowserBase
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
ComVisibleAttribute(true) 
public class WebBrowser extends WebBrowserBase
No aplicable.

El control WebBrowser le permite alojar páginas Web y otros documentos habilitados por explorador de las aplicaciones de Windows Forms. Puede utilizar el control WebBrowser, por ejemplo, para proporcionar ayuda a los usuarios basada en HTML integrado o funcionalidad de exploración Web en la aplicación. Además, puede utilizar el control WebBrowser para agregar los controles basados en Web existentes a las aplicaciones cliente de formularios Windows Forms.

NotaImportante:

El control WebBrowser hace un uso intensivo de los recursos. No olvide llamar al método Dispose cuando haya terminado de utilizar el control para asegurarse de que todos los recursos se liberan puntualmente. Debe llamar al método Dispose en el mismo subproceso que asoció los eventos, que siempre debe ser el subproceso de mensaje o de la interfaz de usuario.

El código de confianza parcial no puede usar el control WebBrowser. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

El control WebBrowser tiene varias propiedades, métodos y eventos relacionados con la exploración. Los miembros siguientes le permiten explorar el control hasta una dirección URL específica, ir hacia delante y hacia atrás por la lista del historial de exploración y cargar las páginas de inicio y búsqueda del usuario actual:

Si la exploración es incorrecta, se muestra una página que indica el problema. La exploración con cualquiera de estos miembros provoca que se produzcan los eventos Navigating, Navigated y DocumentCompleted en fases diferentes de la exploración.

Éstos y otros miembros, como los métodos Stop y Refresh, permiten implementar los controles de la interfaz de usuario en la aplicación de forma similar a los de Internet Explorer. Algunos miembros son útiles aunque no desee que se muestre el control WebBrowser en el formulario. Por ejemplo, puede utilizar el método Print para imprimir la última versión de una página Web sin mostrarla al usuario.

El control WebBrowser también le permite mostrar el contenido creado en la aplicación o recuperado de una base de datos o de un archivo de recursos. Utilice las propiedades DocumentText o DocumentStream para obtener o establecer el contenido del documento actual como cadena o secuencia de datos.

Además, puede manipular el contenido de una página Web mediante la propiedad Document, que contiene un objeto HtmlDocument que proporciona acceso administrado al Modelo de objetos de documento (DOM) HTML de la página actual. Esta propiedad es útil, cuando se utiliza en combinación con la propiedad ObjectForScripting, para implementar la comunicación bidireccional entre el código de la aplicación y el HTML dinámico (DHTML) de una página Web. De esta forma, puede combinar controles basados en Web y controles de formularios Windows Forms en una sola interfaz de usuario. Puede utilizar la propiedad Document para llamar a los métodos de código de secuencias de comandos desde la aplicación. El código de secuencias de comandos puede tener acceso a la aplicación mediante el objeto window.external, que es un objeto DOM integrado proporcionado para el acceso del host, y que se asigna al objeto especificado para la propiedad ObjectForScripting.

NotaNota:

Esta clase realiza peticiones de seguridad en el nivel de clase. Se produce una SecurityException cuando una clase derivada o cualquier llamador de la pila de llamadas no tiene el permiso del plena confianza. Para obtener más información sobre las peticiones de seguridad, vea Peticiones de vínculos y Peticiones de herencia.

NotaNota:

La clase WebBrowser sólo se puede utilizar en subprocesos establecidos en el modo de apartamento de un único subproceso (STA). Para utilizar esta clase, asegúrese de que su método Main está marcado con el atributo STAThreadAttribute.

Nota de la plataforma Windows Mobile 2003 para Pocket PC, Windows Mobile 2003 para Smartphone, Windows CE: La funcionalidad completa para WebBrowser en aplicaciones de .NET Compact Framework requiere el software de la versión 5.0 de Windows Mobile para Pocket PC y Smartphones. Para obtener más información, vea Cómo: Utilizar el control WebBrowser en .NET Compact Framework.

El ejemplo de código siguiente muestra la implementación de una barra de direcciones para su uso con el control WebBrowser. En este ejemplo se requiere que haya un formulario que contenga un control WebBrowser denominado webBrowser1, un control TextBox denominado TextBoxAddress y un control Button denominado ButtonGo. Cuando escribe una dirección URL en el cuadro de texto y presiona la tecla ENTRAR o hace clic en el botón Ir, el control WebBrowser se desplaza hasta la dirección URL especificada. Cuando se desplaza haciendo clic en un hipervínculo, el cuadro de texto se actualiza automáticamente para mostrar la dirección URL actual.

Para obtener un ejemplo completo de código, vea Cómo: Agregar funciones de explorador Web a una aplicación de Windows Forms.

// Navigates to the URL in the address box when 
// the ENTER key is pressed while the ToolStripTextBox has focus.
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Navigate(toolStripTextBox1.Text);
    }
}

// Navigates to the URL in the address box when 
// the Go button is clicked.
private void goButton_Click(object sender, EventArgs e)
{
    Navigate(toolStripTextBox1.Text);
}

// Navigates to the given URL if it is valid.
private void Navigate(String address)
{
    if (String.IsNullOrEmpty(address)) return;
    if (address.Equals("about:blank")) return;
    if (!address.StartsWith("http://") &&
        !address.StartsWith("https://"))
    {
        address = "http://" + address;
    }
    try
    {
        webBrowser1.Navigate(new Uri(address));
    }
    catch (System.UriFormatException)
    {
        return;
    }
}

// Updates the URL in TextBoxAddress upon navigation.
private void webBrowser1_Navigated(object sender,
    WebBrowserNavigatedEventArgs e)
{
    toolStripTextBox1.Text = webBrowser1.Url.ToString();
}

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

.NET Compact Framework

Compatible con: 2.0
Mostrar:
© 2015 Microsoft