WebBrowser.Navigate 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將指定位置處的文件載入至 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);

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 控制項藉由下載它來重載目前的頁面，確保控制項顯示最新版本。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控制項
• IWebBrowser2 介面

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

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

備註

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

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

控制項 WebBrowser 會將最近流覽的網站網頁儲存在本機硬碟上的快取中。 每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。 當控制項巡覽至頁面時，如果有快取的版本可用，它可節省時間，而不是再次下載頁面。 Refresh使用 方法來強制 WebBrowser 控制項藉由下載它來重載目前的頁面，確保控制項顯示最新版本。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控制項
• IWebBrowser2 介面

Navigate(Uri, Boolean)

將指定的 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

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 視窗時，使用者可以按一下 [ 重新 整理] 按鈕來擷取最新版本。

另請參閱

• GoBack()
• GoForward()
• NewWindow
• Refresh()
• WebBrowser 控制項
• IWebBrowser2 介面

Navigate(Uri, String)

將指定的 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

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

targetFrameName

String

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

例外狀況

ObjectDisposedException

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

InvalidOperationException

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

ArgumentException

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

備註

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

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

控制項 WebBrowser 會將最近流覽的網站網頁儲存在本機硬碟上的快取中。 每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。 當控制項巡覽至頁面時，如果有快取的版本可用，它可節省時間，而不是再次下載頁面。 Refresh使用 方法來強制 WebBrowser 控制項藉由下載它來重載目前的頁面，確保控制項顯示最新版本。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控制項
• IWebBrowser2 介面

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 會維護流覽會話期間所流覽之所有網頁的歷程記錄清單。 當您使用 newWindow 的參數值 false 呼叫這個多載時，控制項會正常巡覽至指定的 URI，並將 URI 新增至歷程記錄清單的結尾。 當您使用 newWindow 的參數值 true 呼叫這個多載時， WebBrowser 控制項會將位於指定 URI 的檔載入至新的 Internet Explorer 視窗，以維護自己的流覽歷程記錄。 您可以處理 NewWindow 事件以在開啟新的瀏覽器視窗之前接收通知，讓您視需要取消動作。

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

另請參閱

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

Navigate(String, String)

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

要載入之文件的 URL。

targetFrameName

String

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

例外狀況

ObjectDisposedException

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

InvalidOperationException

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

備註

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

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

控制項 WebBrowser 會將最近流覽的網站網頁儲存在本機硬碟上的快取中。 每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。 當控制項巡覽至頁面時，如果有快取的版本可用，它可節省時間，而不是再次下載頁面。 Refresh使用 方法來強制 WebBrowser 控制項藉由下載它來重載目前的頁面，確保控制項顯示最新版本。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控制項
• IWebBrowser2 介面

Navigate(Uri)

將指定的 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

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使用 方法，在向後流覽後返回流覽歷程記錄中的稍後頁面。

控制項 WebBrowser 會將最近流覽的網站網頁儲存在本機硬碟上的快取中。 每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。 當控制項巡覽至頁面時，如果有快取的版本可用，它可節省時間，而不是再次下載頁面。 Refresh使用 方法來強制 WebBrowser 控制項藉由下載它來重載目前的頁面，確保控制項顯示最新版本。

您可以使用 Navigate 方法來實作類似 Internet Explorer 中的網址列。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控制項
• IWebBrowser2 介面

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

備註

控制項 WebBrowser 會維護流覽會話期間所流覽之所有網頁的歷程記錄清單。 當您呼叫此多載時， WebBrowser 控制項會巡覽至指定的 URI，並將它新增至歷程記錄清單的結尾。 使用 方法， GoBack 將控制項傳回流覽歷程記錄中的上一頁。 GoForward使用 方法，在向後流覽後返回流覽歷程記錄中的稍後頁面。

控制項 WebBrowser 會將最近流覽的網站網頁儲存在本機硬碟上的快取中。 每個頁面都可以指定到期日，指出其會保留在快取中的時間長度。 當控制項巡覽至頁面時，如果有快取的版本可用，它可節省時間，而不是再次下載頁面。 Refresh使用 方法來強制 WebBrowser 控制項藉由下載它來重載目前的頁面，確保控制項顯示最新版本。

您可以使用 Navigate 方法來實作類似 Internet Explorer 中的網址列。

另請參閱

• GoBack()
• GoForward()
• Refresh()
• WebBrowser 控制項
• IWebBrowser2 介面