WebBrowser.Navigate 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將指定位置的文件載入 WebBrowser 控制項。

多載

名稱	Description
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）到新的瀏覽器視窗或 WebBrowser 控制項中。
Navigate(String, String)	將指定的統一資源定位符（URL）載入文件， WebBrowser 並將網頁框架的內容替換為指定名稱。
Navigate(Uri)	將文件載入指定位置 Uri ，取代 WebBrowser 先前的文件。
Navigate(String)	將指定的統一資源定位符（URL）載入文件， WebBrowser 取代先前的文件。

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

來源:

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);

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

A 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 會將最近造訪網站的網頁儲存在本地硬碟的快取中。 每個頁面都可以指定一個到期日，表示它在快取中會停留多久。 當控制項導覽到頁面時，會顯示快取版本（若有快取版本），而非重複下載該頁面，從而節省時間。 使用RefreshWebBrowser下載控制項強制重新載入當前頁面的方法，確保控制項顯示最新版本。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 介面

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

來源:

WebBrowser.cs

將指定的統一資源定位符（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);

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

要載入的文件網址。

targetFrameName

String

載入文件的框架名稱。

postData

Byte[]

HTTP POST 資料，例如表單資料。

additionalHeaders

String

HTTP 標頭要加到預設標頭上。

例外狀況

ObjectDisposedException

這個 WebBrowser 例子已經不再有效。

InvalidOperationException

無法從底層的 ActiveX IWebBrowser2 控制項中取得介面實作WebBrowser的參考。

備註

控制系統 WebBrowser 會維護瀏覽過程中所有瀏覽網頁的歷史清單。 當你呼叫這個超載時，控制項 WebBrowser 會將指定 URI 的文件載入指定名稱的網頁框架，並將該 URI 加入歷史清單的末尾。 若指定的框架名稱無效，文件會載入新的 Internet Explorer 視窗。

使用該 GoBack 方法將控制項返回導航歷史的上一頁。 使用此 GoForward 方法，在向後導航後返回導航歷史的後面頁面。

控制項 WebBrowser 會將最近造訪網站的網頁儲存在本地硬碟的快取中。 每個頁面都可以指定一個到期日，表示它在快取中會停留多久。 當控制項導覽到頁面時，會顯示快取版本（若有快取版本），而非重複下載該頁面，從而節省時間。 使用RefreshWebBrowser下載控制項強制重新載入當前頁面的方法，確保控制項顯示最新版本。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 介面

Navigate(Uri, Boolean)

來源:

WebBrowser.cs

將文件載入指定的位置 Uri ，進入新的瀏覽器視窗或 WebBrowser 控制項。

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

A Uri 代表要載入的文件網址。

newWindow

Boolean

true 將文件載入新的瀏覽器視窗; false 將文件載入控制項 WebBrowser 。

例外狀況

ObjectDisposedException

這個 WebBrowser 例子已經不再有效。

InvalidOperationException

無法從底層的 ActiveX IWebBrowser2 控制項中取得介面實作WebBrowser的參考。

ArgumentException

參數 url 值並不代表絕對的 URI。 如需詳細資訊，請參閱IsAbsoluteUri。

備註

控制系統 WebBrowser 會維護瀏覽過程中所有瀏覽網頁的歷史清單。 當你呼叫這個超載並設定 newWindow 參數值為 false時，控制項會正常導覽到指定的 URI，並將該 URI 加入歷史清單的末尾。 當你呼叫此超載時，newWindow 參數值為 true，WebBrowser 控制項會將指定的 URI 文件載入新的 Internet Explorer 視窗，該視窗會維持自己的導覽歷史。 你可以處理 NewWindow 事件，在開啟新瀏覽器視窗前接收通知，必要時可取消該動作。

控制項 WebBrowser 會將最近造訪網站的網頁儲存在本地硬碟的快取中。 每個頁面都可以指定一個到期日，表示它在快取中會停留多久。 當控制項導航到頁面或將頁面載入獨立瀏覽器視窗時，若有快取版本，會顯示快取版本，節省時間，而非重新下載該頁面。 使用RefreshWebBrowser下載控制項強制重新載入當前頁面的方法，確保控制項顯示最新版本。 當頁面載入獨立Internet Explorer視窗時，使用者可點擊 Refresh 按鈕取得最新版本。

另請參閱

• GoBack()
• GoForward()
• NewWindow
• Refresh()
• IWebBrowser2 介面

Navigate(Uri, String)

來源:

WebBrowser.cs

將文件載入指定位置 Uri ，並 WebBrowser 以指定名稱取代網頁框架的內容。

public:
 void Navigate(Uri ^ url, System::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

A Uri 代表要載入的文件網址。

targetFrameName

String

載入文件的框架名稱。

例外狀況

ObjectDisposedException

這個 WebBrowser 例子已經不再有效。

InvalidOperationException

無法從底層的 ActiveX IWebBrowser2 控制項中取得介面實作WebBrowser的參考。

ArgumentException

參數 url 值並不代表絕對的 URI。 如需詳細資訊，請參閱IsAbsoluteUri。

備註

控制系統 WebBrowser 會維護瀏覽過程中所有瀏覽網頁的歷史清單。 當你呼叫這個超載時，控制項 WebBrowser 會將指定 URI 的文件載入指定名稱的網頁框架，並將該 URI 加入歷史清單的末尾。 若指定的框架名稱無效，文件會載入新的 Internet Explorer 視窗。

使用該 GoBack 方法將控制項返回導航歷史的上一頁。 使用此 GoForward 方法，在向後導航後返回導航歷史的後面頁面。

控制項 WebBrowser 會將最近造訪網站的網頁儲存在本地硬碟的快取中。 每個頁面都可以指定一個到期日，表示它在快取中會停留多久。 當控制項導覽到頁面時，會顯示快取版本（若有快取版本），而非重複下載該頁面，從而節省時間。 使用RefreshWebBrowser下載控制項強制重新載入當前頁面的方法，確保控制項顯示最新版本。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 介面

Navigate(String, Boolean)

來源:

WebBrowser.cs

將文件載入指定的統一資源定位符（URL）到新的瀏覽器視窗或 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

要載入的文件網址。

newWindow

Boolean

true 將文件載入新的瀏覽器視窗; false 將文件載入控制項 WebBrowser 。

例外狀況

ObjectDisposedException

這個 WebBrowser 例子已經不再有效。

InvalidOperationException

無法從底層的 ActiveX IWebBrowser2 控制項中取得介面實作WebBrowser的參考。

備註

控制系統 WebBrowser 會維護瀏覽過程中所有瀏覽網頁的歷史清單。 當你呼叫這個超載並設定 newWindow 參數值為 false時，控制項會正常導覽到指定的 URI，並將該 URI 加入歷史清單的末尾。 當你呼叫此超載時，newWindow 參數值為 true，WebBrowser 控制項會將指定的 URI 文件載入新的 Internet Explorer 視窗，該視窗會維持自己的導覽歷史。 你可以處理 NewWindow 事件，在開啟新瀏覽器視窗前接收通知，必要時可取消該動作。

控制項 WebBrowser 會將最近造訪網站的網頁儲存在本地硬碟的快取中。 每個頁面都可以指定一個到期日，表示它在快取中會停留多久。 當控制項導航到頁面或將頁面載入獨立瀏覽器視窗時，若有快取版本，會顯示快取版本，節省時間，而非重新下載該頁面。 使用RefreshWebBrowser下載控制項強制重新載入當前頁面的方法，確保控制項顯示最新版本。 當頁面載入獨立Internet Explorer視窗時，使用者可點擊 Refresh 按鈕取得最新版本。

另請參閱

• GoBack()
• GoForward()
• NewWindow
• Refresh()

Navigate(String, String)

來源:

WebBrowser.cs

將指定的統一資源定位符（URL）載入文件， WebBrowser 並將網頁框架的內容替換為指定名稱。

public:
 void Navigate(System::String ^ urlString, System::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

要載入的文件網址。

targetFrameName

String

載入文件的框架名稱。

例外狀況

ObjectDisposedException

這個 WebBrowser 例子已經不再有效。

InvalidOperationException

無法從底層的 ActiveX IWebBrowser2 控制項中取得介面實作WebBrowser的參考。

備註

控制系統 WebBrowser 會維護瀏覽過程中所有瀏覽網頁的歷史清單。 當你呼叫這個超載時，控制項 WebBrowser 會將指定 URI 的文件載入指定名稱的網頁框架，並將該 URI 加入歷史清單的末尾。 若指定的框架名稱無效，文件會載入新的 Internet Explorer 視窗。

使用該 GoBack 方法將控制項返回導航歷史的上一頁。 使用此 GoForward 方法，在向後導航後返回導航歷史的後面頁面。

控制項 WebBrowser 會將最近造訪網站的網頁儲存在本地硬碟的快取中。 每個頁面都可以指定一個到期日，表示它在快取中會停留多久。 當控制項導覽到頁面時，會顯示快取版本（若有快取版本），而非重複下載該頁面，從而節省時間。 使用RefreshWebBrowser下載控制項強制重新載入當前頁面的方法，確保控制項顯示最新版本。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 介面

Navigate(Uri)

來源:

WebBrowser.cs

將文件載入指定位置 Uri ，取代 WebBrowser 先前的文件。

public:
 void Navigate(Uri ^ url);

public void Navigate(Uri? url);

member this.Navigate : Uri -> unit

Public Sub Navigate (url As Uri)

參數

url

Uri

A Uri 代表要載入的文件網址。

例外狀況

ObjectDisposedException

這個 WebBrowser 例子已經不再有效。

InvalidOperationException

無法從底層的 ActiveX IWebBrowser2 控制項中取得介面實作WebBrowser的參考。

ArgumentException

參數 url 值並不代表絕對的 URI。 如需詳細資訊，請參閱IsAbsoluteUri。

範例

以下程式碼範例示範如何使用此 Navigate 方法實作控制項的 WebBrowser 位址列。 此範例要求你的形式包含WebBrowser一個名為 webBrowser1、一個TextBox稱為 TextBoxAddress的控制項，以及Button一個稱為 的控制項。ButtonGo 當你在文字框輸入網址並按下 Enter 或點擊 Go 按鈕時， WebBrowser 控制鍵會導向指定的網址。 當你點擊超連結瀏覽時，文字框會自動更新為目前的網址。

完整程式碼範例請參見 如何：在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 方法，在向後導航後返回導航歷史的後面頁面。

控制項 WebBrowser 會將最近造訪網站的網頁儲存在本地硬碟的快取中。 每個頁面都可以指定一個到期日，表示它在快取中會停留多久。 當控制項導覽到頁面時，會顯示快取版本（若有快取版本），而非重複下載該頁面，從而節省時間。 使用RefreshWebBrowser下載控制項強制重新載入當前頁面的方法，確保控制項顯示最新版本。

你可以用 Navigate 方法實作一個類似 Internet Explorer 的地址列。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 介面

Navigate(String)

來源:

WebBrowser.cs

將指定的統一資源定位符（URL）載入文件， 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

要載入的文件網址。

例外狀況

ObjectDisposedException

這個 WebBrowser 例子已經不再有效。

InvalidOperationException

無法從底層的 ActiveX IWebBrowser2 控制項中取得介面實作WebBrowser的參考。

備註

控制系統 WebBrowser 會維護瀏覽過程中所有瀏覽網頁的歷史清單。 當你呼叫這個超載時， WebBrowser 控制項會導向指定的 URI，並將其加入歷史清單的末尾。 使用該 GoBack 方法將控制項返回導航歷史的上一頁。 使用此 GoForward 方法，在向後導航後返回導航歷史的後面頁面。

控制項 WebBrowser 會將最近造訪網站的網頁儲存在本地硬碟的快取中。 每個頁面都可以指定一個到期日，表示它在快取中會停留多久。 當控制項導覽到頁面時，會顯示快取版本（若有快取版本），而非重複下載該頁面，從而節省時間。 使用RefreshWebBrowser下載控制項強制重新載入當前頁面的方法，確保控制項顯示最新版本。

你可以用 Navigate 方法實作一個類似 Internet Explorer 的地址列。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• IWebBrowser2 介面