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

.NET Framework

.NET Framework Client Profile

• SecurityPermission  

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

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz

Weitere Ressourcen