WebBrowser.Navigate 메서드

정의

지정된 Uri에서 문서를 비동기적으로 탐색합니다.Navigate asynchronously to the document at the specified Uri.

오버로드

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

지정된 URL에서 문서를 비동기적으로 탐색하고 문서의 콘텐츠를 로드할 대상 프레임을 지정합니다.Navigates asynchronously to the document at the specified URL and specify the target frame to load the document's content into. 추가 HTTP POST 데이터 및 HTTP 헤더를 서버에 탐색 요청의 일부로 보낼 수 있습니다.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

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

지정된 Uri에서 문서를 비동기적으로 탐색하고 문서의 콘텐츠를 로드할 대상 프레임을 지정합니다.Navigate asynchronously to the document at the specified Uri and specify the target frame to load the document's content into. 추가 HTTP POST 데이터 및 HTTP 헤더를 서버에 탐색 요청의 일부로 보낼 수 있습니다.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

Navigate(String)

지정된 URL에서 문서를 비동기적으로 탐색합니다.Navigates asynchronously to the document at the specified URL.

Navigate(Uri)

지정된 Uri에서 문서를 비동기적으로 탐색합니다.Navigate asynchronously to the document at the specified Uri.

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

지정된 URL에서 문서를 비동기적으로 탐색하고 문서의 콘텐츠를 로드할 대상 프레임을 지정합니다.Navigates asynchronously to the document at the specified URL and specify the target frame to load the document's content into. 추가 HTTP POST 데이터 및 HTTP 헤더를 서버에 탐색 요청의 일부로 보낼 수 있습니다.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

public:
 void Navigate(System::String ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate (string source, string targetFrameName, byte[] postData, string additionalHeaders);
member this.Navigate : string * string * byte[] * string -> unit
Public Sub Navigate (source As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)

매개 변수

source
String

탐색할 URL입니다.The URL to navigate to.

targetFrameName
String

문서의 콘텐츠를 표시할 프레임의 이름입니다.The name of the frame to display the document's content in.

postData
Byte[]

소스가 요청될 때 서버에 보낼 HTTP POST 데이터입니다.HTTP POST data to send to the server when the source is requested.

additionalHeaders
String

소스가 요청될 때 서버에 보낼 HTTP 헤더입니다.HTTP headers to send to the server when the source is requested.

설명

Navigate(String, String, Byte[], String)이스케이프 문자를 포함할 수 있는 URL로 이동 하려면 메서드를 사용 합니다.Use the Navigate(String, String, Byte[], String) method to navigate to a URL that may include escape characters. Navigate(Uri, String, Byte[], String)이스케이프 문자를 포함 하지 않는로 이동 하려면 메서드를 사용 Uri 합니다.Use the Navigate(Uri, String, Byte[], String) method to navigate to a Uri that does not include escape characters.

적용 대상

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

지정된 Uri에서 문서를 비동기적으로 탐색하고 문서의 콘텐츠를 로드할 대상 프레임을 지정합니다.Navigate asynchronously to the document at the specified Uri and specify the target frame to load the document's content into. 추가 HTTP POST 데이터 및 HTTP 헤더를 서버에 탐색 요청의 일부로 보낼 수 있습니다.Additional HTTP POST data and HTTP headers can be sent to the server as part of the navigation request.

public:
 void Navigate(Uri ^ source, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);
public void Navigate (Uri source, string targetFrameName, byte[] postData, string additionalHeaders);
member this.Navigate : Uri * string * byte[] * string -> unit
Public Sub Navigate (source As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)

매개 변수

source
Uri

탐색할 Uri입니다.The Uri to navigate to.

targetFrameName
String

문서의 콘텐츠를 표시할 프레임의 이름입니다.The name of the frame to display the document's content in.

postData
Byte[]

소스가 요청될 때 서버에 보낼 HTTP POST 데이터입니다.HTTP POST data to send to the server when the source is requested.

additionalHeaders
String

소스가 요청될 때 서버에 보낼 HTTP 헤더입니다.HTTP headers to send to the server when the source is requested.

예외

WebBrowser 인스턴스가 더 이상 유효하지 않습니다.The WebBrowser instance is no longer valid.

기본 네이티브 WebBrowser에 대한 참조를 검색할 수 없습니다.A reference to the underlying native WebBrowser could not be retrieved.

부분 신뢰로 실행되고 있는 애플리케이션에서Navigation from an application that is running in partial trust: - 원본 사이트에 없는 Uri로 탐색할 경우 또는- To a Uri that is not located at the site of origin, or

  • targetFrameName 이름이 null이거나 비어 있지 않은 경우
  • targetFrameName name is not null or empty.
  • 예제

    다음 예제에서는 "about: blank" 대상을 지정 하 여 문서를 탐색 하 고 새 브라우저 창에서 문서를 여는 방법을 보여 줍니다.The following example shows how to navigate to a document and open it in a new browser window by specifying the "about:blank" target.

    <StackPanel>  
        <StackPanel Orientation="Horizontal">  
            <TextBox x:Name="addressTextBox" Width="200" />  
            <Button Click="goNavigateButton_Click">Go</Button>  
        </StackPanel>  
        <WebBrowser x:Name="myWebBrowser" />  
    </StackPanel>  
    
    private void goNavigateButton_Click(object sender, RoutedEventArgs e)  
    {  
        // Get URI to navigate to  
        Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);  
    
        // Only absolute URIs can be navigated to  
        if (!uri.IsAbsoluteUri)  
        {  
            MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
            return;  
        }  
    
        // Navigate to the desired URL by calling the .Navigate method  
        this.myWebBrowser.Navigate(uri, "_blank", null, null);  
    }  
    

    설명

    Navigate(String, String, Byte[], String)이스케이프 문자를 포함할 수 있는 URL로 이동 하려면 메서드를 사용 합니다.Use the Navigate(String, String, Byte[], String) method to navigate to a URL that may include escape characters. Navigate(Uri, String, Byte[], String)이스케이프 문자를 포함 하지 않는로 이동 하려면 메서드를 사용 Uri 합니다.Use the Navigate(Uri, String, Byte[], String) method to navigate to a Uri that does not include escape characters.

    적용 대상

    Navigate(String)

    지정된 URL에서 문서를 비동기적으로 탐색합니다.Navigates asynchronously to the document at the specified URL.

    public:
     void Navigate(System::String ^ source);
    public void Navigate (string source);
    member this.Navigate : string -> unit
    Public Sub Navigate (source As String)

    매개 변수

    source
    String

    탐색할 URL입니다.The URL to navigate to.

    설명

    Navigate(String)이스케이프 문자를 포함할 수 있는 URL로 이동 하려면 메서드를 사용 합니다.Use the Navigate(String) method to navigate to a URL that may include escape characters. Navigate(Uri)이스케이프 문자를 포함 하지 않는로 이동 하려면 메서드를 사용 Uri 합니다.Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

    적용 대상

    Navigate(Uri)

    지정된 Uri에서 문서를 비동기적으로 탐색합니다.Navigate asynchronously to the document at the specified Uri.

    public:
     void Navigate(Uri ^ source);
    public void Navigate (Uri source);
    member this.Navigate : Uri -> unit
    Public Sub Navigate (source As Uri)

    매개 변수

    source
    Uri

    탐색할 Uri입니다.The Uri to navigate to.

    예외

    WebBrowser 인스턴스가 더 이상 유효하지 않습니다.The WebBrowser instance is no longer valid.

    기본 네이티브 WebBrowser에 대한 참조를 검색할 수 없습니다.A reference to the underlying native WebBrowser could not be retrieved.

    부분 신뢰로 실행되고 있는 애플리케이션에서 원본 사이트에 없는 Uri로 탐색할 경우Navigation from an application that is running in partial trust to a Uri that is not located at the site of origin.

    예제

    다음 예제에서는 메서드를 사용 하 WebBrowser 여 문서를 탐색 하는 데를 사용 하는 방법을 보여 줍니다 Navigate(Uri) .The following example shows how to use WebBrowser to navigate to a document by using the Navigate(Uri) method.

    <StackPanel>  
        <StackPanel Orientation="Horizontal">  
            <TextBox x:Name="addressTextBox" Width="200" />  
            <Button Click="goNavigateButton_Click">Go</Button>  
        </StackPanel>  
        <WebBrowser x:Name="myWebBrowser" />  
    </StackPanel>  
    
    private void goNavigateButton_Click(object sender, RoutedEventArgs e)  
    {  
        // Get URI to navigate to  
        Uri uri = new Uri(this.addressTextBox.Text, UriKind.RelativeOrAbsolute);  
    
        // Only absolute URIs can be navigated to  
        if (!uri.IsAbsoluteUri)  
        {  
            MessageBox.Show("The Address URI must be absolute. For example, 'http://www.microsoft.com'");  
            return;  
        }  
    
        // Navigate to the desired URL by calling the .Navigate method  
        this.myWebBrowser.Navigate(uri);  
    }  
    

    설명

    를 호출 Navigate(Uri) 하면 속성을 설정 하는 것과 동일한 효과가 있습니다 Source .Calling Navigate(Uri) has the same effect as setting the Source property. SourceWebBrowser 초기화 될 때 탐색 하는 초기 문서를 선언적으로 지정 하려는 개발자가 태그에서 사용 됩니다 WebBrowser .Source is used from markup by developers who want to declaratively specify the initial document that WebBrowser navigates to when WebBrowser is initialized.

    Navigate(String)이스케이프 문자를 포함할 수 있는 URL로 이동 하려면 메서드를 사용 합니다.Use the Navigate(String) method to navigate to a URL that may include escape characters. Navigate(Uri)이스케이프 문자를 포함 하지 않는로 이동 하려면 메서드를 사용 Uri 합니다.Use the Navigate(Uri) method to navigate to a Uri that does not include escape characters.

    적용 대상