WebBrowser.Navigated WebBrowser.Navigated WebBrowser.Navigated WebBrowser.Navigated Event

정의

WebBrowser 컨트롤에서 새 문서를 탐색하여 문서 로드를 시작한 경우 발생합니다.Occurs when the WebBrowser control has navigated to a new document and has begun loading it.

public:
 event System::Windows::Forms::WebBrowserNavigatedEventHandler ^ Navigated;
public event System.Windows.Forms.WebBrowserNavigatedEventHandler Navigated;
member this.Navigated : System.Windows.Forms.WebBrowserNavigatedEventHandler 
Public Custom Event Navigated As WebBrowserNavigatedEventHandler 

예제

다음 코드 예제에 대 한 처리기를 사용 하는 방법에 설명 합니다 Navigated 이벤트에 대 한 주소 표시줄을 구현 하는 WebBrowser 제어 합니다.The following code example demonstrates how to use a handler for the Navigated event to implement an address bar for the WebBrowser control. 이 예제에서는 폼에는 WebBrowser 이라는 컨트롤 webBrowser1, TextBox 이라는 컨트롤 TextBoxAddress, 및 Button 이라는 컨트롤 ButtonGo합니다.This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. 텍스트 상자에 URL을 입력 하 고 ENTER 키를 누르거나 클릭 하면 합니다 이동 단추를 WebBrowser 컨트롤 지정 된 URL로 이동 합니다.When you type a URL into the text box and press ENTER or click the Go button, the WebBrowser control navigates to the URL specified. 하이퍼링크를 클릭 하 여로 이동 하면 현재 URL을 표시할 입력란 자동으로 업데이트 합니다.When you navigate by clicking a hyperlink, the text box automatically updates to display the current URL.

전체 코드 예제를 보려면 방법: Windows Forms 애플리케이션에 웹 브라우저 기능 추가합니다.For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

// Navigates to the URL in the address text box when 
// the ENTER key is pressed while the text box has focus.
void TextBoxAddress_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
{
   if ( e->KeyCode == System::Windows::Forms::Keys::Enter &&  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Navigates to the URL in the address text box when 
// the Go button is clicked.
void ButtonGo_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   if (  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Updates the URL in TextBoxAddress upon navigation.
void WebBrowser1_Navigated( Object^ /*sender*/, System::Windows::Forms::WebBrowserNavigatedEventArgs^ /*e*/ )
{
   this->TextBoxAddress->Text = this->WebBrowser1->Url->ToString();
}

// Navigates to the URL in the address box when 
// the ENTER key is pressed while the ToolStripTextBox has focus.
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Navigate(toolStripTextBox1.Text);
    }
}

// Navigates to the URL in the address box when 
// the Go button is clicked.
private void goButton_Click(object sender, EventArgs e)
{
    Navigate(toolStripTextBox1.Text);
}

// Navigates to the given URL if it is valid.
private void Navigate(String address)
{
    if (String.IsNullOrEmpty(address)) return;
    if (address.Equals("about:blank")) return;
    if (!address.StartsWith("http://") &&
        !address.StartsWith("https://"))
    {
        address = "http://" + address;
    }
    try
    {
        webBrowser1.Navigate(new Uri(address));
    }
    catch (System.UriFormatException)
    {
        return;
    }
}

// Updates the URL in TextBoxAddress upon navigation.
private void webBrowser1_Navigated(object sender,
    WebBrowserNavigatedEventArgs e)
{
    toolStripTextBox1.Text = webBrowser1.Url.ToString();
}

' Navigates to the URL in the address box when 
' the ENTER key is pressed while the ToolStripTextBox has focus.
Private Sub toolStripTextBox1_KeyDown( _
    ByVal sender As Object, ByVal e As KeyEventArgs) _
    Handles toolStripTextBox1.KeyDown

    If (e.KeyCode = Keys.Enter) Then
        Navigate(toolStripTextBox1.Text)
    End If

End Sub

' Navigates to the URL in the address box when 
' the Go button is clicked.
Private Sub goButton_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles goButton.Click

    Navigate(toolStripTextBox1.Text)

End Sub

' Navigates to the given URL if it is valid.
Private Sub Navigate(ByVal address As String)

    If String.IsNullOrEmpty(address) Then Return
    If address.Equals("about:blank") Then Return
    If Not address.StartsWith("http://") And _
        Not address.StartsWith("https://") Then
        address = "http://" & address
    End If

    Try
        webBrowser1.Navigate(New Uri(address))
    Catch ex As System.UriFormatException
        Return
    End Try

End Sub

' Updates the URL in TextBoxAddress upon navigation.
Private Sub webBrowser1_Navigated(ByVal sender As Object, _
    ByVal e As WebBrowserNavigatedEventArgs) _
    Handles webBrowser1.Navigated

    toolStripTextBox1.Text = webBrowser1.Url.ToString()

End Sub

설명

WebBrowser 컨트롤 집합은 다음 속성 중 하나 또는 메서드가 호출 될 때마다 새 문서를 탐색 합니다.The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:

처리를 Navigated 이벤트 알림을 받을 때의 WebBrowser 컨트롤이 새 문서를 탐색 합니다.Handle the Navigated event to receive notification when the WebBrowser control has navigated to a new document. 경우는 Navigated 새 문서를 통해 로드 된 콘텐츠에 액세스할 수 있습니다 즉 로드가 시작 이벤트가 발생 합니다 Document, DocumentText, 및 DocumentStream 속성입니다.When the Navigated event occurs, the new document has begun loading, which means you can access the loaded content through the Document, DocumentText, and DocumentStream properties. 처리를 DocumentCompleted 이벤트 알림을 받을 때의 WebBrowser 컨트롤이 새 문서 로드를 완료할 합니다.Handle the DocumentCompleted event to receive notification when the WebBrowser control finishes loading the new document.

처리 하 여 탐색이 시작 되기 전에 알림을 받을 수도 있습니다는 Navigating 이벤트입니다.You can also receive notification before navigation begins by handling the Navigating event. 이 이벤트를 처리 하면 특정 조건이 충족 되지 않은 경우 탐색을 취소할 예를 들어 사용자가 작성 하지 않은 완전히 폼입니다.Handling this event lets you cancel navigation if certain conditions have not been met, for example, the user has not completely filled out a form.

이벤트 처리에 대한 자세한 내용은 이벤트 처리 및 발생 을 참조하십시오.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.

적용 대상

추가 정보