WebBrowser.Navigate 메서드

정의

네임스페이스:: System.Windows.Forms

어셈블리:: System.Windows.Forms.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

지정된 위치에 있는 문서를 컨트롤에 로드합니다 WebBrowser .

오버로드

Name	Description
Navigate(Uri, String, Byte[], String)	지정된 Uri WebBrowser HTTP 데이터를 사용하여 문서를 요청하고 웹 페이지 프레임의 내용을 지정된 이름으로 바꿔서 지정한 위치에 문서를 컨트롤에 로드합니다.
Navigate(String, String, Byte[], String)	지정된 URL(Uniform Resource Locator)의 문서를 컨트롤에 WebBrowser 로드하여 지정된 HTTP 데이터를 사용하여 요청하고 웹 페이지 프레임의 내용을 지정된 이름으로 바꿔줍니다.
Navigate(Uri, Boolean)	지정 Uri 한 위치의 문서를 새 브라우저 창이나 컨트롤에 WebBrowser 로드합니다.
Navigate(Uri, String)	지정 Uri 한 위치에 있는 문서를 컨트롤에 WebBrowser 로드하여 웹 페이지 프레임의 내용을 지정된 이름으로 바꿔줍니다.
Navigate(String, Boolean)	지정된 URL(Uniform Resource Locator)의 문서를 새 브라우저 창이나 컨트롤에 WebBrowser 로드합니다.
Navigate(String, String)	지정된 URL(Uniform Resource Locator)의 문서를 컨트롤에 WebBrowser 로드하여 웹 페이지 프레임의 내용을 지정된 이름으로 바꿔줍니다.
Navigate(Uri)	지정 Uri 한 위치의 문서를 컨트롤에 WebBrowser 로드하여 이전 문서를 바꿉니다.
Navigate(String)	지정한 URL(Uniform Resource Locator)의 문서를 컨트롤에 로드하여 WebBrowser 이전 문서를 바꿉니다.

Navigate(Uri, String, Byte[], String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

지정된 Uri WebBrowser HTTP 데이터를 사용하여 문서를 요청하고 웹 페이지 프레임의 내용을 지정된 이름으로 바꿔서 지정한 위치에 문서를 컨트롤에 로드합니다.

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate(Uri url, string targetFrameName, byte[] postData, string additionalHeaders);

public void Navigate(Uri? url, string? targetFrameName, byte[]? postData, string? additionalHeaders);

member this.Navigate : Uri * string * byte[] * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)

매개 변수

url: Uri

Uri 로드할 문서의 URL을 나타내는 값입니다.

targetFrameName: String

문서를 로드할 프레임의 이름입니다.

postData: Byte[]

양식 데이터와 같은 HTTP POST 데이터입니다.

additionalHeaders: String

기본 헤더에 추가할 HTTP 헤더입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스는 더 이상 유효하지 않습니다.

InvalidOperationException

인터페이스 구현에 대한 참조를 IWebBrowser2 기본 ActiveX WebBrowser 컨트롤에서 검색할 수 없습니다.

ArgumentException

매개 변수 값이 url 절대 URI를 나타내지 않습니다. 자세한 내용은 IsAbsoluteUri를 참조하세요.

설명

컨트롤은 WebBrowser 검색 세션 중에 방문한 모든 웹 페이지의 기록 목록을 유지 관리합니다. 이 오버로드를 호출하면 컨트롤은 WebBrowser 지정된 URI의 문서를 지정된 이름으로 웹 페이지 프레임에 로드하고 기록 목록의 끝에 URI를 추가합니다. 지정한 프레임 이름이 유효하지 않으면 문서가 새 Internet Explorer 창에 로드됩니다.

메서드를 GoBack 사용하여 탐색 기록의 이전 페이지로 컨트롤을 반환합니다. GoForward 뒤로 이동한 후 탐색 기록의 이후 페이지로 돌아가려면 이 메서드를 사용합니다.

컨트롤은 WebBrowser 최근에 방문한 사이트의 웹 페이지를 로컬 하드 디스크의 캐시에 저장합니다. 각 페이지는 캐시에 남아 있는 기간을 나타내는 만료 날짜를 지정할 수 있습니다. 컨트롤이 페이지로 이동하면 페이지를 다시 다운로드하지 않고 캐시된 버전을 표시하여 시간을 절약할 수 있습니다. 이 메서드를 Refresh 사용하여 컨트롤을 WebBrowser 다운로드하여 컨트롤이 현재 페이지를 다시 로드하도록 하여 컨트롤에 최신 버전이 표시되도록 합니다.

추가 정보

적용 대상

Navigate(String, String, Byte[], String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

지정된 URL(Uniform Resource Locator)의 문서를 컨트롤에 WebBrowser 로드하여 지정된 HTTP 데이터를 사용하여 요청하고 웹 페이지 프레임의 내용을 지정된 이름으로 바꿔줍니다.

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate(string urlString, string targetFrameName, byte[] postData, string additionalHeaders);

public void Navigate(string urlString, string? targetFrameName, byte[]? postData, string? additionalHeaders);

member this.Navigate : string * string * byte[] * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)

매개 변수

urlString: String

로드할 문서의 URL입니다.

targetFrameName: String

문서를 로드할 프레임의 이름입니다.

postData: Byte[]

양식 데이터와 같은 HTTP POST 데이터입니다.

additionalHeaders: String

기본 헤더에 추가할 HTTP 헤더입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스는 더 이상 유효하지 않습니다.

InvalidOperationException

인터페이스 구현에 대한 참조를 IWebBrowser2 기본 ActiveX WebBrowser 컨트롤에서 검색할 수 없습니다.

설명

추가 정보

적용 대상

Navigate(Uri, Boolean)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

지정 Uri 한 위치의 문서를 새 브라우저 창이나 컨트롤에 WebBrowser 로드합니다.

public:
 void Navigate(Uri ^ url, bool newWindow);

public void Navigate(Uri url, bool newWindow);

public void Navigate(Uri? url, bool newWindow);

member this.Navigate : Uri * bool -> unit

Public Sub Navigate (url As Uri, newWindow As Boolean)

매개 변수

url: Uri

Uri 로드할 문서의 URL을 나타내는 값입니다.

newWindow: Boolean

true 문서를 새 브라우저 창에 로드하려면 입니다. false 을 클릭하여 문서를 컨트롤에 로드합니다 WebBrowser .

예외

ObjectDisposedException

이 WebBrowser 인스턴스는 더 이상 유효하지 않습니다.

InvalidOperationException

인터페이스 구현에 대한 참조를 IWebBrowser2 기본 ActiveX WebBrowser 컨트롤에서 검색할 수 없습니다.

ArgumentException

매개 변수 값이 url 절대 URI를 나타내지 않습니다. 자세한 내용은 IsAbsoluteUri를 참조하세요.

설명

컨트롤은 WebBrowser 검색 세션 중에 방문한 모든 웹 페이지의 기록 목록을 유지 관리합니다. 매개 변수 값false으로 이 오버로드를 newWindow 호출하면 컨트롤은 일반적으로 지정된 URI로 이동하고 기록 목록의 끝에 URI를 추가합니다. newWindow 매개 변수 값이 true 이 오버로드를 호출하면 WebBrowser 컨트롤은 지정된 URI의 문서를 새 Internet Explorer 창으로 로드하여 자체 탐색 기록을 유지합니다. 새 브라우저 창을 열기 전에 알림을 수신하도록 이벤트를 처리 NewWindow 하여 필요한 경우 작업을 취소할 수 있습니다.

컨트롤은 WebBrowser 최근에 방문한 사이트의 웹 페이지를 로컬 하드 디스크의 캐시에 저장합니다. 각 페이지는 캐시에 남아 있는 기간을 나타내는 만료 날짜를 지정할 수 있습니다. 컨트롤이 페이지로 이동하거나 페이지를 별도의 브라우저 창으로 로드하면 페이지를 다시 다운로드하지 않고 캐시된 버전을 표시하여 시간을 절약할 수 있습니다. 이 메서드를 Refresh 사용하여 컨트롤을 WebBrowser 다운로드하여 컨트롤이 현재 페이지를 다시 로드하도록 하여 컨트롤에 최신 버전이 표시되도록 합니다. 페이지가 별도의 Internet Explorer 창에 로드되면 사용자는 Refresh 단추를 클릭하여 최신 버전을 검색할 수 있습니다.

추가 정보

적용 대상

Navigate(Uri, String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

지정 Uri 한 위치에 있는 문서를 컨트롤에 WebBrowser 로드하여 웹 페이지 프레임의 내용을 지정된 이름으로 바꿔줍니다.

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName);

public void Navigate(Uri url, string targetFrameName);

public void Navigate(Uri? url, string? targetFrameName);

member this.Navigate : Uri * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String)

매개 변수

url: Uri

Uri 로드할 문서의 URL을 나타내는 값입니다.

targetFrameName: String

문서를 로드할 프레임의 이름입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스는 더 이상 유효하지 않습니다.

InvalidOperationException

인터페이스 구현에 대한 참조를 IWebBrowser2 기본 ActiveX WebBrowser 컨트롤에서 검색할 수 없습니다.

ArgumentException

매개 변수 값이 url 절대 URI를 나타내지 않습니다. 자세한 내용은 IsAbsoluteUri를 참조하세요.

설명

추가 정보

적용 대상

Navigate(String, Boolean)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

지정된 URL(Uniform Resource Locator)의 문서를 새 브라우저 창이나 컨트롤에 WebBrowser 로드합니다.

public:
 void Navigate(System::String ^ urlString, bool newWindow);

public void Navigate(string urlString, bool newWindow);

member this.Navigate : string * bool -> unit

Public Sub Navigate (urlString As String, newWindow As Boolean)

매개 변수

urlString: String

로드할 문서의 URL입니다.

newWindow: Boolean

true 문서를 새 브라우저 창에 로드하려면 입니다. false 을 클릭하여 문서를 컨트롤에 로드합니다 WebBrowser .

예외

ObjectDisposedException

이 WebBrowser 인스턴스는 더 이상 유효하지 않습니다.

InvalidOperationException

인터페이스 구현에 대한 참조를 IWebBrowser2 기본 ActiveX WebBrowser 컨트롤에서 검색할 수 없습니다.

설명

추가 정보

적용 대상

Navigate(String, String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

지정된 URL(Uniform Resource Locator)의 문서를 컨트롤에 WebBrowser 로드하여 웹 페이지 프레임의 내용을 지정된 이름으로 바꿔줍니다.

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName);

public void Navigate(string urlString, string targetFrameName);

public void Navigate(string urlString, string? targetFrameName);

member this.Navigate : string * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String)

매개 변수

urlString: String

로드할 문서의 URL입니다.

targetFrameName: String

문서를 로드할 프레임의 이름입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스는 더 이상 유효하지 않습니다.

InvalidOperationException

인터페이스 구현에 대한 참조를 IWebBrowser2 기본 ActiveX WebBrowser 컨트롤에서 검색할 수 없습니다.

설명

추가 정보

적용 대상

Navigate(Uri)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

지정 Uri 한 위치의 문서를 컨트롤에 WebBrowser 로드하여 이전 문서를 바꿉니다.

public:
 void Navigate(Uri ^ url);

public void Navigate(Uri url);

public void Navigate(Uri? url);

member this.Navigate : Uri -> unit

Public Sub Navigate (url As Uri)

매개 변수

url: Uri

Uri 로드할 문서의 URL을 나타내는 값입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스는 더 이상 유효하지 않습니다.

InvalidOperationException

인터페이스 구현에 대한 참조를 IWebBrowser2 기본 ActiveX WebBrowser 컨트롤에서 검색할 수 없습니다.

ArgumentException

매개 변수 값이 url 절대 URI를 나타내지 않습니다. 자세한 내용은 IsAbsoluteUri를 참조하세요.

예제

다음 코드 예제에서는 컨트롤에 Navigate 대 한 주소 표시줄을 구현 하는 메서드를 사용 하는 방법을 보여 줍니다 WebBrowser . 이 예제에서는 폼에 호출된 WebBrowser 컨트롤, 호출webBrowser1된 컨트롤 및 호출TextBoxTextBoxAddress된 Button 컨트롤을 ButtonGo 포함해야 합니다. 입력란에 URL을 입력하고 Enter 키를 누르거나 이동 단추를 클릭하면 컨트롤이 WebBrowser 지정된 URL로 이동합니다. 하이퍼링크를 클릭하여 탐색하면 텍스트 상자가 자동으로 업데이트되어 현재 URL이 표시됩니다.

전체 코드 예제는 방법: Windows Forms 애플리케이션에 웹 브라우저 기능 추가 참조하세요.

// 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 검색 세션 중에 방문한 모든 웹 페이지의 기록 목록을 유지 관리합니다. 이 오버로드를 호출하면 컨트롤이 WebBrowser 지정된 URI로 이동하여 기록 목록의 끝에 추가합니다. 메서드를 GoBack 사용하여 탐색 기록의 이전 페이지로 컨트롤을 반환합니다. GoForward 뒤로 이동한 후 탐색 기록의 이후 페이지로 돌아가려면 이 메서드를 사용합니다.

Navigate 메서드를 사용하여 Internet Explorer 주소 표시줄과 유사한 주소 표시줄을 구현할 수 있습니다.

추가 정보

적용 대상

Navigate(String)

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

Source:: WebBrowser.cs

지정한 URL(Uniform Resource Locator)의 문서를 컨트롤에 로드하여 WebBrowser 이전 문서를 바꿉니다.

public:
 void Navigate(System::String ^ urlString);

public void Navigate(string urlString);

member this.Navigate : string -> unit

Public Sub Navigate (urlString As String)

매개 변수

urlString: String

로드할 문서의 URL입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스는 더 이상 유효하지 않습니다.

InvalidOperationException

인터페이스 구현에 대한 참조를 IWebBrowser2 기본 ActiveX WebBrowser 컨트롤에서 검색할 수 없습니다.

설명

Navigate 메서드를 사용하여 Internet Explorer 주소 표시줄과 유사한 주소 표시줄을 구현할 수 있습니다.

추가 정보

적용 대상

피드백

이 페이지가 도움이 되었나요?