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) 處的文件載入至新瀏覽器視窗或 WebBrowser 控制項。
Navigate(String, String)	將指定之統一資源定位器 (URL) 處的文件載入至 WebBrowser 控制項，會使用指定的名稱來取代網頁框架的內容。
Navigate(Uri)	將指定的 Uri 所表示之位置處的文件載入至 WebBrowser 控制項，會取代前一份文件。
Navigate(String)	將指定之統一資源定位器 (URL) 處的文件載入至 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

Uri，代表要載入之文件的 URL。

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 介面實作的參考。

備註

GoBack使用方法，將控件傳回瀏覽歷程記錄中的上一頁。 GoForward使用方法，在向後巡覽后返回瀏覽歷程記錄中的稍後頁面。

另請參閱

適用於

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

Uri，代表要載入之文件的 URL。

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 會將最近瀏覽的網站網頁儲存在本機硬碟上的快取中。每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。當控件巡覽至頁面或將頁面載入個別瀏覽器視窗中時，如果有快取的版本可用，而不是再次下載頁面，可節省時間。 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

Uri，代表要載入之文件的 URL。

targetFrameName: String

在其中載入文件的框架名稱。

例外狀況

ObjectDisposedException

這個 WebBrowser 執行個體已不再有效。

InvalidOperationException

無法從基礎 ActiveX IWebBrowser2 控制項中擷取 WebBrowser 介面實作的參考。

ArgumentException

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

備註

GoBack使用方法，將控件傳回瀏覽歷程記錄中的上一頁。 GoForward使用方法，在向後巡覽后返回瀏覽歷程記錄中的稍後頁面。

另請參閱

適用於

Navigate(String, Boolean)

將指定的統一資源定位器 (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

要載入之文件的 URL。

newWindow: Boolean

true 會將文件載入至新瀏覽器視窗，false 則會將文件載入至 WebBrowser 控制項。

例外狀況

ObjectDisposedException

這個 WebBrowser 執行個體已不再有效。

InvalidOperationException

無法從基礎 ActiveX IWebBrowser2 控制項中擷取 WebBrowser 介面實作的參考。

備註

控件 WebBrowser 會將最近瀏覽的網站網頁儲存在本機硬碟上的快取中。每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。當控件巡覽至頁面或將頁面載入個別的瀏覽器視窗中時，如果有快取的版本可用，則不會再次下載頁面，藉此節省時間。 Refresh使用方法來強制WebBrowser控件藉由下載它來重載目前的頁面，確保控件顯示最新版本。當頁面載入至個別的 Internet Explorer 視窗時，使用者可以按兩下 [ 重新整理] 按鈕來擷取最新版本。

另請參閱

適用於

Navigate(String, String)

將指定之統一資源定位器 (URL) 處的文件載入至 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 介面實作的參考。

備註

控件 WebBrowser 會維護瀏覽會話期間所流覽之所有網頁的歷程記錄清單。當您呼叫此多載時， WebBrowser 控件會將位於指定 URI 的檔載入至具有指定名稱的網頁框架，並將 URI 新增至歷程記錄清單的結尾。如果指定的框架名稱無效，則會將檔載入新的 Internet Explorer 視窗中。

使用方法， GoBack 將控件傳回瀏覽歷程記錄中的上一頁。 GoForward使用方法，在向後流覽後返回瀏覽歷程記錄中的稍後頁面。

控件 WebBrowser 會將最近瀏覽的網站網頁儲存在本機硬碟上的快取中。每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。當控件巡覽至頁面時，如果有快取的版本可用，它可節省時間，而不是再次下載頁面。 Refresh使用方法來強制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

Uri，代表要載入之文件的 URL。

例外狀況

ObjectDisposedException

這個 WebBrowser 執行個體已不再有效。

InvalidOperationException

無法從基礎 ActiveX IWebBrowser2 控制項中擷取 WebBrowser 介面實作的參考。

ArgumentException

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

範例

下列程式代碼範例示範如何使用 Navigate 方法來實作控件的 WebBrowser 網址列。此範例會要求您的表單包含 WebBrowser 名為 webBrowser1的控制件、 TextBox 名為 TextBoxAddress的控制件，以及 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)

將指定之統一資源定位器 (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

要載入之文件的 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)

參數

例外狀況

備註

另請參閱

適用於

其他資源