WebBrowser.DocumentCompleted WebBrowser.DocumentCompleted WebBrowser.DocumentCompleted WebBrowser.DocumentCompleted Event

Определение

Происходит по завершении загрузки документа элементом управления WebBrowser.Occurs when the WebBrowser control finishes loading a document.

public:
 event System::Windows::Forms::WebBrowserDocumentCompletedEventHandler ^ DocumentCompleted;
public event System.Windows.Forms.WebBrowserDocumentCompletedEventHandler DocumentCompleted;
member this.DocumentCompleted : System.Windows.Forms.WebBrowserDocumentCompletedEventHandler 
Public Event DocumentCompleted As WebBrowserDocumentCompletedEventHandler 

Примеры

В следующем примере кода показано использование этого события для печати документа после его полной загрузки.The following code example demonstrates the use of this event to print a document after it has fully loaded.

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

Комментарии

WebBrowser Элемент управления переходит к новому документу каждый раз, когда задано одно из следующих свойств или вызывается метод:The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:

DocumentCompleted Обрабатывает событие для получения уведомления о завершении загрузки нового документа.Handle the DocumentCompleted event to receive notification when the new document finishes loading. Когда происходит Document DocumentText DocumentStream событие, новый документ загружается полностью, что означает, что доступ к его содержимому можно получить с помощью свойства, или. DocumentCompletedWhen the DocumentCompleted event occurs, the new document is fully loaded, which means you can access its contents through the Document, DocumentText, or DocumentStream property.

Чтобы получить уведомление перед началом навигации, обработайте Navigating событие.To receive notification before navigation begins, handle the Navigating event. Обработка этого события позволяет отменить навигацию, если определенные условия не выполнены, например, когда пользователь не заполнил форму полностью.Handling this event lets you cancel navigation if certain conditions have not been met, for example, when the user has not completely filled out a form. Обрабатывает событие, чтобы получить уведомление, WebBrowser когда элемент управления завершает навигацию и начал загрузку документа в новом расположении. NavigatedHandle the Navigated event to receive notification when the WebBrowser control finishes navigation and has begun loading the document at the new location.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about handling events, see Handling and Raising Events.

Безопасность

SecurityPermission
для использования этого элемента управления немедленно вызывающими объектами.for immediate callers to use this control. Значение спроса: LinkDemand; Именованные наборы разрешений: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Применяется к

Дополнительно