WebBrowser.Navigate Metodo

Definizione

Carica nel controllo WebBrowser il documento nel percorso specificato.Loads the document at the specified location into the WebBrowser control.

Overload

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

Carica il documento nel percorso specificato dall'indicatore Uri nel controllo WebBrowser con la richiesta di usare i dati HTTP specificati e sostituendo il contenuto del frame della pagina Web con il nome specificato.Loads the document at the location indicated by the specified Uri into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

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

Carica il documento nell'URL (Uniform Resource Locator) specificato nel controllo WebBrowser con la richiesta di usare i dati HTTP specificati e sostituendo il contenuto del frame della pagina Web con il nome specificato.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

Navigate(Uri, Boolean)

Carica il documento nel percorso specificato dall'indicatore Uri in una nuova finestra del browser o nel controllo WebBrowser.Loads the document at the location indicated by the specified Uri into a new browser window or into the WebBrowser control.

Navigate(Uri, String)

Carica il documento nel percorso specificato dall'indicatore Uri nel controllo WebBrowser sostituendo il contenuto del frame della pagina Web con il nome specificato.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the contents of the Web page frame with the specified name.

Navigate(String, Boolean)

Carica il documento nell'URL (Uniform Resource Locator) specificato in una nuova finestra del browser o nel controllo WebBrowser.Loads the document at the specified Uniform Resource Locator (URL) into a new browser window or into the WebBrowser control.

Navigate(String, String)

Carica il documento nell'URL (Uniform Resource Locator) specificato nel controllo WebBrowser sostituendo il contenuto del frame della pagina Web con il nome specificato.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the contents of the Web page frame with the specified name.

Navigate(Uri)

Carica il documento nel percorso specificato dall'indicatore Uri nel controllo WebBrowser sostituendo il documento precedente.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the previous document.

Navigate(String)

Carica il documento nell'URL (Uniform Resource Locator) specificato nel controllo WebBrowser sostituendo il documento precedente.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the previous document.

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

Carica il documento nel percorso specificato dall'indicatore Uri nel controllo WebBrowser con la richiesta di usare i dati HTTP specificati e sostituendo il contenuto del frame della pagina Web con il nome specificato.Loads the document at the location indicated by the specified Uri into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

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)

Parametri

url
Uri

Oggetto Uri che rappresenta l'URL del documento da caricare.A Uri representing the URL of the document to load.

targetFrameName
String

Nome del frame nel quale caricare il documento.The name of the frame in which to load the document.

postData
Byte[]

Dati HTTP POST come dati del form.HTTP POST data such as form data.

additionalHeaders
String

Intestazioni HTTP da aggiungere alle intestazioni predefinite.HTTP headers to add to the default headers.

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Il valore del parametro url non rappresenta un URI assoluto.The url parameter value does not represent an absolute URI. Per altre informazioni, vedere IsAbsoluteUri.For more information, see IsAbsoluteUri.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si chiama questo overload, il WebBrowser controllo carica il documento in corrispondenza dell'URI specificato nel frame della pagina Web con il nome specificato e aggiunge l'URI alla fine dell'elenco della cronologia.When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. Se il nome del frame specificato non è valido, il documento viene caricato in una nuova finestra di Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Usare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione.Use the GoBack method to return the control to a previous page in the navigation history. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo la navigazione all'indietro.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Vedi anche

Si applica a

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

Carica il documento nell'URL (Uniform Resource Locator) specificato nel controllo WebBrowser con la richiesta di usare i dati HTTP specificati e sostituendo il contenuto del frame della pagina Web con il nome specificato.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, requesting it using the specified HTTP data and replacing the contents of the Web page frame with the specified name.

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)

Parametri

urlString
String

URL del documento da caricare.The URL of the document to load.

targetFrameName
String

Nome del frame nel quale caricare il documento.The name of the frame in which to load the document.

postData
Byte[]

Dati HTTP POST come dati del form.HTTP POST data such as form data.

additionalHeaders
String

Intestazioni HTTP da aggiungere alle intestazioni predefinite.HTTP headers to add to the default headers.

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si chiama questo overload, il WebBrowser controllo carica il documento in corrispondenza dell'URI specificato nel frame della pagina Web con il nome specificato e aggiunge l'URI alla fine dell'elenco della cronologia.When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. Se il nome del frame specificato non è valido, il documento viene caricato in una nuova finestra di Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Usare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione.Use the GoBack method to return the control to a previous page in the navigation history. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo la navigazione all'indietro.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Vedi anche

Si applica a

Navigate(Uri, Boolean)

Carica il documento nel percorso specificato dall'indicatore Uri in una nuova finestra del browser o nel controllo WebBrowser.Loads the document at the location indicated by the specified Uri into a new browser window or into the WebBrowser control.

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)

Parametri

url
Uri

Oggetto Uri che rappresenta l'URL del documento da caricare.A Uri representing the URL of the document to load.

newWindow
Boolean

true per caricare il documento in una nuova finestra del browser; false per caricare il documento nel controllo WebBrowser.true to load the document into a new browser window; false to load the document into the WebBrowser control.

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Il valore del parametro url non rappresenta un URI assoluto.The url parameter value does not represent an absolute URI. Per altre informazioni, vedere IsAbsoluteUri.For more information, see IsAbsoluteUri.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si chiama questo overload con un newWindow valore di parametro false , il controllo si sposta normalmente nell'URI specificato e aggiunge l'URI alla fine dell'elenco della cronologia.When you call this overload with a newWindow parameter value of false, the control navigates to the specified URI normally and adds the URI to the end of the history list. Quando si chiama questo overload con un newWindow valore di parametro true , il WebBrowser controllo carica il documento nell'URI specificato in una nuova finestra di Internet Explorer, che mantiene la propria cronologia di navigazione.When you call this overload with a newWindow parameter value of true, the WebBrowser control loads the document at the specified URI into a new Internet Explorer window, which maintains its own navigation history. È possibile gestire l' NewWindow evento per ricevere una notifica prima dell'apertura di una nuova finestra del browser, consentendo di annullare l'azione, se necessario.You can handle the NewWindow event to receive notification before a new browser window is opened, allowing you to cancel the action if necessary.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina o carica una pagina in una finestra del browser distinta, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.When the control navigates to a page or loads a page into a separate browser window, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version. Quando una pagina viene caricata in una finestra di Internet Explorer separata, l'utente può recuperare la versione più recente facendo clic sul pulsante Aggiorna .When a page is loaded into a separate Internet Explorer window, the user can retrieve the latest version by clicking the Refresh button.

Vedi anche

Si applica a

Navigate(Uri, String)

Carica il documento nel percorso specificato dall'indicatore Uri nel controllo WebBrowser sostituendo il contenuto del frame della pagina Web con il nome specificato.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the contents of the Web page frame with the specified name.

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)

Parametri

url
Uri

Oggetto Uri che rappresenta l'URL del documento da caricare.A Uri representing the URL of the document to load.

targetFrameName
String

Nome del frame nel quale caricare il documento.The name of the frame in which to load the document.

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Il valore del parametro url non rappresenta un URI assoluto.The url parameter value does not represent an absolute URI. Per altre informazioni, vedere IsAbsoluteUri.For more information, see IsAbsoluteUri.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si chiama questo overload, il WebBrowser controllo carica il documento in corrispondenza dell'URI specificato nel frame della pagina Web con il nome specificato e aggiunge l'URI alla fine dell'elenco della cronologia.When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. Se il nome del frame specificato non è valido, il documento viene caricato in una nuova finestra di Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Usare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione.Use the GoBack method to return the control to a previous page in the navigation history. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo la navigazione all'indietro.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Vedi anche

Si applica a

Navigate(String, Boolean)

Carica il documento nell'URL (Uniform Resource Locator) specificato in una nuova finestra del browser o nel controllo WebBrowser.Loads the document at the specified Uniform Resource Locator (URL) into a new browser window or into the WebBrowser control.

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)

Parametri

urlString
String

URL del documento da caricare.The URL of the document to load.

newWindow
Boolean

true per caricare il documento in una nuova finestra del browser; false per caricare il documento nel controllo WebBrowser.true to load the document into a new browser window; false to load the document into the WebBrowser control.

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si chiama questo overload con un newWindow valore di parametro false , il controllo si sposta normalmente nell'URI specificato e aggiunge l'URI alla fine dell'elenco della cronologia.When you call this overload with a newWindow parameter value of false, the control navigates to the specified URI normally and adds the URI to the end of the history list. Quando si chiama questo overload con un newWindow valore di parametro true , il WebBrowser controllo carica il documento nell'URI specificato in una nuova finestra di Internet Explorer, che mantiene la propria cronologia di navigazione.When you call this overload with a newWindow parameter value of true, the WebBrowser control loads the document at the specified URI into a new Internet Explorer window, which maintains its own navigation history. È possibile gestire l' NewWindow evento per ricevere una notifica prima dell'apertura di una nuova finestra del browser, consentendo di annullare l'azione, se necessario.You can handle the NewWindow event to receive notification before a new browser window is opened, allowing you to cancel the action if necessary.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina o carica una pagina in una finestra del browser distinta, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.When the control navigates to a page or loads a page into a separate browser window, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version. Quando una pagina viene caricata in una finestra di Internet Explorer separata, l'utente può recuperare la versione più recente facendo clic sul pulsante Aggiorna .When a page is loaded into a separate Internet Explorer window, the user can retrieve the latest version by clicking the Refresh button.

Vedi anche

Si applica a

Navigate(String, String)

Carica il documento nell'URL (Uniform Resource Locator) specificato nel controllo WebBrowser sostituendo il contenuto del frame della pagina Web con il nome specificato.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the contents of the Web page frame with the specified name.

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)

Parametri

urlString
String

URL del documento da caricare.The URL of the document to load.

targetFrameName
String

Nome del frame nel quale caricare il documento.The name of the frame in which to load the document.

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si chiama questo overload, il WebBrowser controllo carica il documento in corrispondenza dell'URI specificato nel frame della pagina Web con il nome specificato e aggiunge l'URI alla fine dell'elenco della cronologia.When you call this overload, the WebBrowser control loads the document at the specified URI into the Web page frame with the specified name, and adds the URI to the end of the history list. Se il nome del frame specificato non è valido, il documento viene caricato in una nuova finestra di Internet Explorer.If the frame name specified is invalid, the document is loaded into a new Internet Explorer window.

Usare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione.Use the GoBack method to return the control to a previous page in the navigation history. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo la navigazione all'indietro.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

Vedi anche

Si applica a

Navigate(Uri)

Carica il documento nel percorso specificato dall'indicatore Uri nel controllo WebBrowser sostituendo il documento precedente.Loads the document at the location indicated by the specified Uri into the WebBrowser control, replacing the previous document.

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

Parametri

url
Uri

Oggetto Uri che rappresenta l'URL del documento da caricare.A Uri representing the URL of the document to load.

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Il valore del parametro url non rappresenta un URI assoluto.The url parameter value does not represent an absolute URI. Per altre informazioni, vedere IsAbsoluteUri.For more information, see IsAbsoluteUri.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il Navigate metodo per implementare una barra degli indirizzi per il WebBrowser controllo.The following code example demonstrates how to use the Navigate method to implement an address bar for the WebBrowser control. Questo esempio richiede che il form contenga un WebBrowser controllo denominato webBrowser1 , un TextBox controllo denominato TextBoxAddress e un Button controllo denominato ButtonGo .This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. Quando si digita un URL nella casella di testo e si preme INVIO o si fa clic sul pulsante Vai , il WebBrowser controllo passa all'URL specificato.When you type a URL into the text box and press ENTER or click the Go button, the WebBrowser control navigates to the URL specified. Quando si esegue la navigazione facendo clic su un collegamento ipertestuale, la casella di testo viene aggiornata automaticamente per visualizzare l'URL corrente.When you navigate by clicking a hyperlink, the text box automatically updates to display the current URL.

Per l'esempio di codice completo, vedere procedura: aggiungere funzionalità del browser Web a un'applicazione Windows Forms.For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

// 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

Commenti

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si chiama questo overload, il WebBrowser controllo passa all'URI specificato e lo aggiunge alla fine dell'elenco della cronologia.When you call this overload, the WebBrowser control navigates to the specified URI and adds it to the end of the history list. Usare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione.Use the GoBack method to return the control to a previous page in the navigation history. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo la navigazione all'indietro.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

È possibile utilizzare il Navigate metodo per implementare una barra degli indirizzi simile a quella di Internet Explorer.You can use the Navigate method to implement an address bar similar to the one in Internet Explorer.

Vedi anche

Si applica a

Navigate(String)

Carica il documento nell'URL (Uniform Resource Locator) specificato nel controllo WebBrowser sostituendo il documento precedente.Loads the document at the specified Uniform Resource Locator (URL) into the WebBrowser control, replacing the previous document.

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

Parametri

urlString
String

URL del documento da caricare.The URL of the document to load.

Eccezioni

Questa istanza di WebBrowser non è più valida.This WebBrowser instance is no longer valid.

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione.The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. Quando si chiama questo overload, il WebBrowser controllo passa all'URI specificato e lo aggiunge alla fine dell'elenco della cronologia.When you call this overload, the WebBrowser control navigates to the specified URI and adds it to the end of the history list. Usare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione.Use the GoBack method to return the control to a previous page in the navigation history. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo la navigazione all'indietro.Use the GoForward method to return to a later page in the navigation history after navigating backward.

Il WebBrowser controllo archivia le pagine Web da siti visitati di recente in una cache sul disco rigido locale.The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache.Each page can specify an expiration date indicating how long it will remain in the cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare di nuovo la pagina.When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. Usare il Refresh metodo per forzare il WebBrowser controllo per ricaricare la pagina corrente scaricando il controllo, assicurando che il controllo visualizzi la versione più recente.Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

È possibile utilizzare il Navigate metodo per implementare una barra degli indirizzi simile a quella di Internet Explorer.You can use the Navigate method to implement an address bar similar to the one in Internet Explorer.

Vedi anche

Si applica a