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 Custom Event ProgressChanged As 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.ShowConsole.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.

コード例を実行するには、WebBrowser1という WebBrowser 型のインスタンスを含むプロジェクトに貼り付けます。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.

セキュリティ

SecurityPermission
直前の呼び出し元がこのコントロールを使用できるようにします。for immediate callers to use this control. 要求の値: LinkDemand;名前付きアクセス許可セット: FullTrustDemand value: LinkDemand; Named Permission Sets: FullTrust.

適用対象

こちらもご覧ください