WebBrowser.DocumentCompleted Ereignis

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Tritt ein, wenn das WebBrowser-Steuerelement das Laden eines Dokuments beendet.

public:
 event System::Windows::Forms::WebBrowserDocumentCompletedEventHandler ^ DocumentCompleted;

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

Public Event DocumentCompleted As WebBrowserDocumentCompletedEventHandler

Ereignistyp

WebBrowserDocumentCompletedEventHandler

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Ereignisses zum Drucken eines Dokuments veranschaulicht, nachdem es vollständig geladen wurde.

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

Hinweise

Das WebBrowser Steuerelement navigiert immer dann zu einem neuen Dokument, wenn eine der folgenden Eigenschaften festgelegt oder Methoden aufgerufen werden:

Behandeln Sie das DocumentCompleted Ereignis, um eine Benachrichtigung zu erhalten, wenn das Laden des neuen Dokuments abgeschlossen ist. Wenn das DocumentCompleted Ereignis auftritt, wird das neue Dokument vollständig geladen. Dies bedeutet, dass Sie über die -, DocumentText- oder DocumentStream -Eigenschaft auf den DocumentInhalt zugreifen können.

Um Benachrichtigungen zu erhalten, bevor die Navigation beginnt, behandeln Sie das Navigating Ereignis. Wenn Sie dieses Ereignis behandeln, können Sie die Navigation abbrechen, wenn bestimmte Bedingungen nicht erfüllt wurden, z. B. wenn der Benutzer ein Formular nicht vollständig ausgefüllt hat. Behandeln Sie das Navigated Ereignis, um eine Benachrichtigung zu erhalten, wenn das Steuerelement die WebBrowser Navigation beendet und mit dem Laden des Dokuments am neuen Speicherort begonnen hat.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Teilen über