WebBrowser.DocumentCompleted Evento

Definición

Se produce cuando el control WebBrowser termina de cargar un documento.Occurs when the WebBrowser control finishes loading a document.

public:
 event System::Windows::Forms::WebBrowserDocumentCompletedEventHandler ^ DocumentCompleted;
public event System.Windows.Forms.WebBrowserDocumentCompletedEventHandler DocumentCompleted;
member this.DocumentCompleted : System.Windows.Forms.WebBrowserDocumentCompletedEventHandler 
Public Custom Event DocumentCompleted As WebBrowserDocumentCompletedEventHandler 

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este evento para imprimir un documento una vez que se ha cargado por completo.The following code example demonstrates the use of this event to print a document after it has fully loaded.

private void PrintHelpPage()
{
    // Create a WebBrowser instance. 
    WebBrowser webBrowserForPrinting = new WebBrowser();

    // Add an event handler that prints the document after it loads.
    webBrowserForPrinting.DocumentCompleted +=
        new WebBrowserDocumentCompletedEventHandler(PrintDocument);

    // Set the Url property to load the document.
    webBrowserForPrinting.Url = new Uri(@"\\myshare\help.html");
}

private void PrintDocument(object sender,
    WebBrowserDocumentCompletedEventArgs e)
{
    // Print the document now that it is fully loaded.
    ((WebBrowser)sender).Print();

    // Dispose the WebBrowser now that the task is complete. 
    ((WebBrowser)sender).Dispose();
}
Private Sub PrintHelpPage()

    ' Create a WebBrowser instance. 
    Dim webBrowserForPrinting As New WebBrowser()

    ' Add an event handler that prints the document after it loads.
    AddHandler webBrowserForPrinting.DocumentCompleted, New _
        WebBrowserDocumentCompletedEventHandler(AddressOf PrintDocument)

    ' Set the Url property to load the document.
    webBrowserForPrinting.Url = New Uri("\\myshare\help.html")

End Sub

Private Sub PrintDocument(ByVal sender As Object, _
    ByVal e As WebBrowserDocumentCompletedEventArgs)

    Dim webBrowserForPrinting As WebBrowser = CType(sender, WebBrowser)

    ' Print the document now that it is fully loaded.
    webBrowserForPrinting.Print()
    MessageBox.Show("print")

    ' Dispose the WebBrowser now that the task is complete. 
    webBrowserForPrinting.Dispose()

End Sub

Comentarios

El WebBrowser control navega a un nuevo documento cada vez que se establece una de las siguientes propiedades o se llama a métodos:The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:

Controle DocumentCompleted el evento para recibir una notificación cuando el nuevo documento termine de cargarse.Handle the DocumentCompleted event to receive notification when the new document finishes loading. Cuando se DocumentCompleted produce el evento, el nuevo documento se carga por completo, lo que significa que puede tener acceso Documenta su contenido DocumentStream a través de la propiedad, DocumentTexto.When the DocumentCompleted event occurs, the new document is fully loaded, which means you can access its contents through the Document, DocumentText, or DocumentStream property.

Para recibir notificaciones antes de que empiece la Navigating navegación, controle el evento.To receive notification before navigation begins, handle the Navigating event. Controlar este evento permite cancelar la navegación si no se cumplen determinadas condiciones, por ejemplo, cuando el usuario no ha rellenado completamente un formulario.Handling this event lets you cancel navigation if certain conditions have not been met, for example, when the user has not completely filled out a form. Controle Navigated el evento para recibir una notificación WebBrowser cuando el control finalice la navegación y haya empezado a cargar el documento en la nueva ubicación.Handle the Navigated event to receive notification when the WebBrowser control finishes navigation and has begun loading the document at the new location.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.For more information about handling events, see Handling and Raising Events.

Seguridad

SecurityPermission
para que los llamadores inmediatos utilicen este control.for immediate callers to use this control. Valor de petición LinkDemand:; Conjuntos de permisos con nombre: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Se aplica a

Consulte también: