WebBrowser.DocumentCompleted Événement

Définition

Se produit lorsque le contrôle WebBrowser finit de charger un document.

public event System.Windows.Forms.WebBrowserDocumentCompletedEventHandler DocumentCompleted;
public event System.Windows.Forms.WebBrowserDocumentCompletedEventHandler? DocumentCompleted;

Type d'événement

Exemples

L’exemple de code suivant illustre l’utilisation de cet événement pour imprimer un document après son chargement complet.

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();
}

Remarques

Le WebBrowser contrôle accède à un nouveau document chaque fois que l’une des propriétés suivantes est définie ou que des méthodes sont appelées :

Gérez l’événement DocumentCompleted pour recevoir une notification à la fin du chargement du nouveau document. Lorsque l’événement DocumentCompleted se produit, le nouveau document est entièrement chargé, ce qui signifie que vous pouvez accéder à son contenu via la Documentpropriété , DocumentTextou DocumentStream .

Pour recevoir une notification avant le début de la navigation, gérez l’événement Navigating . La gestion de cet événement vous permet d’annuler la navigation si certaines conditions n’ont pas été remplies, par exemple lorsque l’utilisateur n’a pas complètement rempli un formulaire. Gérez l’événement Navigated pour recevoir une notification lorsque le WebBrowser contrôle a terminé la navigation et a commencé à charger le document au nouvel emplacement.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

S’applique à

Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Voir aussi