WebBrowser.Navigate 메서드

참조

정의

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

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

중요

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

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

오버로드

Navigate(Uri, String, Byte[], String)	지정된 Uri가 나타내는 위치에 있는 문서를 WebBrowser 컨트롤에 로드하여 지정된 HTTP 데이터를 통해 이 문서를 요청하고 웹 페이지 프레임의 내용을 지정된 이름으로 바꿉니다.
Navigate(String, String, Byte[], String)	지정된 URL의 문서를 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)

지정된 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

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

targetFrameName: String

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

postData: Byte[]

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

additionalHeaders: String

기본 머리글에 추가할 HTTP 머리글입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스가 더 이상 유효하지 않은 경우

InvalidOperationException

내부 ActiveX IWebBrowser2 컨트롤에서 WebBrowser 인터페이스 구현에 대한 참조를 검색할 수 없는 경우

ArgumentException

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

설명

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

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

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

추가 정보

적용 대상

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

지정된 URL의 문서를 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

내부 ActiveX IWebBrowser2 컨트롤에서 WebBrowser 인터페이스 구현에 대한 참조를 검색할 수 없는 경우

설명

추가 정보

적용 대상

Navigate(Uri, Boolean)

지정된 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

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

newWindow: Boolean

문서를 새 브라우저 창에 로드하면 true이고, 문서를 WebBrowser 컨트롤에 로드하면 false입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스가 더 이상 유효하지 않은 경우

InvalidOperationException

내부 ActiveX IWebBrowser2 컨트롤에서 WebBrowser 인터페이스 구현에 대한 참조를 검색할 수 없는 경우

ArgumentException

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

설명

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

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

추가 정보

적용 대상

Navigate(Uri, String)

지정된 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

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

targetFrameName: String

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

예외

ObjectDisposedException

이 WebBrowser 인스턴스가 더 이상 유효하지 않은 경우

InvalidOperationException

내부 ActiveX IWebBrowser2 컨트롤에서 WebBrowser 인터페이스 구현에 대한 참조를 검색할 수 없는 경우

ArgumentException

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

설명

추가 정보

적용 대상

Navigate(String, Boolean)

지정된 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이고, 문서를 WebBrowser 컨트롤에 로드하면 false입니다.

예외

ObjectDisposedException

이 WebBrowser 인스턴스가 더 이상 유효하지 않은 경우

InvalidOperationException

내부 ActiveX IWebBrowser2 컨트롤에서 WebBrowser 인터페이스 구현에 대한 참조를 검색할 수 없는 경우

설명

추가 정보

적용 대상

Navigate(String, String)

지정된 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

내부 ActiveX IWebBrowser2 컨트롤에서 WebBrowser 인터페이스 구현에 대한 참조를 검색할 수 없는 경우

설명

추가 정보

적용 대상

Navigate(Uri)

지정된 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

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

예외

ObjectDisposedException

이 WebBrowser 인스턴스가 더 이상 유효하지 않은 경우

InvalidOperationException

내부 ActiveX IWebBrowser2 컨트롤에서 WebBrowser 인터페이스 구현에 대한 참조를 검색할 수 없는 경우

ArgumentException

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

예제

다음 코드 예제를 사용 하는 방법을 보여 줍니다는 Navigate 메서드에 대 한 주소 표시줄을 구현 하는 WebBrowser 컨트롤입니다. 이 예제에서는 양식에 라는 컨트롤, TextBox 라는 webBrowser1컨트롤 및 라는 TextBoxAddressButtonGo컨트롤이 Button 포함되어 WebBrowser 야 합니다. 텍스트 상자에 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)

지정된 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

내부 ActiveX IWebBrowser2 컨트롤에서 WebBrowser 인터페이스 구현에 대한 참조를 검색할 수 없는 경우

설명

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

추가 정보

적용 대상

다음을 통해 공유

WebBrowser.Navigate 메서드

정의

오버로드

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

매개 변수

예외

설명

추가 정보

적용 대상

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

매개 변수

예외

설명

추가 정보

적용 대상

Navigate(Uri, Boolean)

매개 변수

예외

설명

추가 정보

적용 대상

Navigate(Uri, String)

매개 변수

예외

설명

추가 정보

적용 대상

Navigate(String, Boolean)

매개 변수

예외

설명

추가 정보

적용 대상

Navigate(String, String)

매개 변수

예외

설명

추가 정보

적용 대상

Navigate(Uri)

매개 변수

예외

예제

설명

추가 정보

적용 대상

Navigate(String)

매개 변수

예외

설명

추가 정보

적용 대상

추가 리소스