WebBrowser.DocumentCompleted Ereignis
Definition
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 auf, 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
Beispiele
Das folgende Codebeispiel veranschaulicht die Verwendung dieses Ereignisses zum Drucken eines Dokuments, 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 zu einem neuen Dokument, wenn eine der folgenden Eigenschaften festgelegt oder Methoden aufgerufen wird:
Behandeln Sie das DocumentCompleted Ereignis, um Benachrichtigungen zu erhalten, wenn das neue Dokument mit dem Laden fertig ist. Wenn das DocumentCompleted Ereignis eintritt, wird das neue Dokument vollständig geladen, was bedeutet, dass Sie über die Document, DocumentTextoder DocumentStream Die Eigenschaft auf dessen Inhalt zugreifen können.
Um eine Benachrichtigung zu erhalten, bevor die Navigation beginnt, behandeln Sie das Navigating Ereignis. Durch die Behandlung dieses Ereignisses können Sie die Navigation abbrechen, wenn bestimmte Bedingungen nicht erfüllt wurden, z. B. wenn der Benutzer kein Formular vollständig ausgefüllt hat. Behandeln Sie das Navigated Ereignis, um Benachrichtigungen zu erhalten, wenn das Steuerelement die WebBrowser Navigation beendet hat und mit dem Laden des Dokuments an der neuen Position begonnen hat.
Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.
