WebBrowser.ProgressChanged Событие

Определение

Происходит, когда элемент управления WebBrowser обновляет данные о ходе загрузки документа, в который перешел этот элемент управления.Occurs when the WebBrowser control has updated information on the download progress of a document it is navigating to.

public:
 event System::Windows::Forms::WebBrowserProgressChangedEventHandler ^ ProgressChanged;
public event System.Windows.Forms.WebBrowserProgressChangedEventHandler ProgressChanged;
member this.ProgressChanged : System.Windows.Forms.WebBrowserProgressChangedEventHandler 
Public Event ProgressChanged As WebBrowserProgressChangedEventHandler 
Public Custom Event ProgressChanged As WebBrowserProgressChangedEventHandler 

Тип события

WebBrowserProgressChangedEventHandler

Примеры

В следующем примере кода показано использование этого элемента.The following code example demonstrates the use of this member. В этом примере обработчик событий сообщает о возникновении ProgressChanged события.In the example, an event handler reports on the occurrence of the ProgressChanged event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке.This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены MessageBox.Show Console.WriteLine или добавления сообщения в многострочный TextBox .To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа WebBrowser с именем WebBrowser1 .To run the example code, paste it into a project that contains an instance of type WebBrowser named WebBrowser1. Затем убедитесь, что обработчик событий связан с ProgressChanged событием.Then ensure that the event handler is associated with the ProgressChanged event.

private void WebBrowser1_ProgressChanged(Object sender, WebBrowserProgressChangedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "CurrentProgress", e.CurrentProgress );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "MaximumProgress", e.MaximumProgress );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ProgressChanged Event" );
}
Private Sub WebBrowser1_ProgressChanged(sender as Object, e as WebBrowserProgressChangedEventArgs) _ 
     Handles WebBrowser1.ProgressChanged

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "CurrentProgress", e.CurrentProgress)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "MaximumProgress", e.MaximumProgress)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"ProgressChanged Event")

End Sub

Комментарии

Обработчик для этого события можно использовать для реализации индикатора хода выполнения навигации, аналогичного показанному в Internet Explorer.You can use a handler for this event to implement a navigation progress bar similar to the one in Internet Explorer. Используйте WebBrowserProgressChangedEventArgs.CurrentProgress свойство, чтобы определить число байтов, которые были успешно скачаны.Use the WebBrowserProgressChangedEventArgs.CurrentProgress property to determine the number of bytes that have been downloaded successfully. Используйте WebBrowserProgressChangedEventArgs.MaximumProgress свойство, чтобы определить общее число байтов, доступных для загрузки.Use the WebBrowserProgressChangedEventArgs.MaximumProgress property to determine the total number of bytes available for downloading.

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

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

См. также раздел