WebBrowser.DocumentCompleted-Ereignis

Das WebBrowser-Steuerelement navigiert zu einem neuen Dokument, wenn eine der folgenden Eigenschaften festgelegt bzw. eine der folgenden Methoden aufgerufen wird:

• Url

• DocumentText

• DocumentStream

• Navigate

• GoBack

• GoForward

• GoHome

• GoSearch

Behandeln Sie das DocumentCompleted-Ereignis, wenn eine Benachrichtigung ausgegeben werden soll, nachdem das Laden des neuen Dokuments beendet ist. Nach dem Eintreten des DocumentCompleted-Ereignisses ist das neue Dokument vollständig geladen, d. h., auf den Inhalt kann über die Document-Eigenschaft, die DocumentText-Eigenschaft oder die DocumentStream-Eigenschaft zugegriffen werden.

Behandeln Sie das Navigating-Ereignis, wenn vor Beginn der Navigation eine Benachrichtigung ausgegeben werden soll. Durch die Behandlung dieses Ereignisses können Sie die Navigation abbrechen, sofern bestimmte Bedingungen nicht erfüllt sind, wenn ein Benutzer beispielsweise ein Formular nicht vollständig ausgefüllt hat. Behandeln Sie das Navigated-Ereignis, um eine Benachrichtigung zu erhalten, wenn das WebBrowser-Steuerelement die Navigation beendet hat und mit dem Laden des Dokuments am neuen Speicherort beginnt.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln von Ereignissen.

Im folgenden Codebeispiel wird veranschaulicht, wie ein Dokument mithilfe dieses Ereignisses nach dem vollständigen Laden gedruckt wird.

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

• SecurityPermission  für unmittelbare Aufrufer, um dieses Steuerelement zu verwenden. Anforderungswert: LinkDemand; Benannte Berechtigungssätze: FullTrust.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

.NET Compact Framework