Condividi tramite

WebBrowser.Navigate Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Carica nel controllo WebBrowser il documento nel percorso specificato.

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.
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.
Navigate(Uri, Boolean)

Carica il documento nel percorso specificato dall'indicatore Uri in una nuova finestra del browser o nel controllo WebBrowser.
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.
Navigate(String, Boolean)

Carica il documento nell'URL (Uniform Resource Locator) specificato in una nuova finestra del browser o nel controllo WebBrowser.
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.
Navigate(Uri)

Carica il documento nel percorso specificato dall'indicatore Uri nel controllo WebBrowser sostituendo il documento precedente.
Navigate(String)

Carica il documento nell'URL (Uniform Resource Locator) specificato nel controllo WebBrowser sostituendo il documento precedente.

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.

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)

Parametri

url
Uri

Oggetto Uri che rappresenta l'URL del documento da caricare.

targetFrameName
String

Nome del frame nel quale caricare il documento.

postData
Byte[]

Dati HTTP POST come dati del form.

additionalHeaders
String

Intestazioni HTTP da aggiungere alle intestazioni predefinite.

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

ArgumentException

Il valore del parametro url non rappresenta un URI assoluto. Per altre informazioni, vedere IsAbsoluteUri.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologie di tutte le pagine Web visitate durante una sessione di esplorazione. Quando si chiama questo overload, il WebBrowser controllo carica il documento nell'URI specificato nel frame di pagina Web con il nome specificato e aggiunge l'URI alla fine dell'elenco di cronologia. Se il nome del frame specificato non è valido, il documento viene caricato in una nuova finestra di Internet Explorer.

Utilizzare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di spostamento. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di spostamento dopo l'spostamento indietro.

Il WebBrowser controllo archivia le pagine Web dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il Refresh metodo per forzare il controllo per ricaricare la WebBrowser pagina corrente scaricandolo, assicurandosi che il controllo visualizzi la versione più recente.

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.

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)

Parametri

urlString
String

URL del documento da caricare.

targetFrameName
String

Nome del frame nel quale caricare il documento.

postData
Byte[]

Dati HTTP POST come dati del form.

additionalHeaders
String

Intestazioni HTTP da aggiungere alle intestazioni predefinite.

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologie di tutte le pagine Web visitate durante una sessione di esplorazione. Quando si chiama questo overload, il WebBrowser controllo carica il documento nell'URI specificato nel frame di pagina Web con il nome specificato e aggiunge l'URI alla fine dell'elenco di cronologia. Se il nome del frame specificato non è valido, il documento viene caricato in una nuova finestra di Internet Explorer.

Utilizzare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di spostamento. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di spostamento dopo l'spostamento indietro.

Il WebBrowser controllo archivia le pagine Web dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il Refresh metodo per forzare il controllo per ricaricare la WebBrowser pagina corrente scaricandolo, assicurandosi che il controllo visualizzi la versione più recente.

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.

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)

Parametri

url
Uri

Oggetto Uri che rappresenta l'URL del documento da caricare.

newWindow
Boolean

true per caricare il documento in una nuova finestra del browser; false per caricare il documento nel controllo WebBrowser.

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

ArgumentException

Il valore del parametro url non rappresenta un URI assoluto. Per altre informazioni, vedere IsAbsoluteUri.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologie di tutte le pagine Web visitate durante una sessione di esplorazione. Quando si chiama questo overload con un newWindow valore di parametro di false, il controllo passa all'URI specificato normalmente e aggiunge l'URI alla fine dell'elenco di cronologia. Quando si chiama questo overload con un newWindow valore di parametro di true, il controllo carica il WebBrowser documento nell'URI specificato in una nuova finestra di Internet Explorer, che mantiene la propria cronologia di spostamento. È possibile gestire l'evento per ricevere una notifica prima dell'apertura NewWindow di una nuova finestra del browser, consentendo di annullare l'azione se necessario.

Il WebBrowser controllo archivia le pagine Web dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina o carica una pagina in una finestra del browser separata, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il Refresh metodo per forzare il controllo per ricaricare la WebBrowser pagina corrente scaricandolo, assicurandosi che il controllo visualizzi la versione più recente. 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 .

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.

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)

Parametri

url
Uri

Oggetto Uri che rappresenta l'URL del documento da caricare.

targetFrameName
String

Nome del frame nel quale caricare il documento.

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

ArgumentException

Il valore del parametro url non rappresenta un URI assoluto. Per altre informazioni, vedere IsAbsoluteUri.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologie di tutte le pagine Web visitate durante una sessione di esplorazione. Quando si chiama questo overload, il WebBrowser controllo carica il documento nell'URI specificato nel frame di pagina Web con il nome specificato e aggiunge l'URI alla fine dell'elenco di cronologia. Se il nome del frame specificato non è valido, il documento viene caricato in una nuova finestra di Internet Explorer.

Utilizzare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di spostamento. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di spostamento dopo l'spostamento indietro.

Il WebBrowser controllo archivia le pagine Web dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il Refresh metodo per forzare il controllo per ricaricare la WebBrowser pagina corrente scaricandolo, assicurandosi che il controllo visualizzi la versione più recente.

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.

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.

newWindow
Boolean

true per caricare il documento in una nuova finestra del browser; false per caricare il documento nel controllo WebBrowser.

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

Commenti

Il WebBrowser controllo gestisce un elenco di cronologie di tutte le pagine Web visitate durante una sessione di esplorazione. Quando si chiama questo overload con un newWindow valore di parametro di false, il controllo passa all'URI specificato normalmente e aggiunge l'URI alla fine dell'elenco di cronologia. Quando si chiama questo overload con un newWindow valore di parametro di true, il controllo carica il WebBrowser documento nell'URI specificato in una nuova finestra di Internet Explorer, che mantiene la propria cronologia di spostamento. È possibile gestire l'evento per ricevere la notifica prima dell'apertura NewWindow di una nuova finestra del browser, consentendo di annullare l'azione, se necessario.

Il WebBrowser controllo archivia le pagine Web dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina o carica una pagina in una finestra separata del browser, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il Refresh metodo per forzare il WebBrowser ricaricamento della pagina corrente scaricandolo, assicurandosi che il controllo visualizzi la versione più recente. Quando una pagina viene caricata in una finestra separata di Internet Explorer, l'utente può recuperare la versione più recente facendo clic sul pulsante Aggiorna .

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.

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)

Parametri

urlString
String

URL del documento da caricare.

targetFrameName
String

Nome del frame nel quale caricare il documento.

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

Commenti

Il WebBrowser controllo mantiene un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione. Quando si chiama questo overload, il WebBrowser controllo carica il documento nell'URI specificato nel frame di pagina Web con il nome specificato e aggiunge l'URI alla fine dell'elenco di cronologia. Se il nome del frame specificato non è valido, il documento viene caricato in una nuova finestra di Internet Explorer.

Utilizzare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo lo spostamento indietro.

Il WebBrowser controllo archivia le pagine Web dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il Refresh metodo per forzare il WebBrowser ricaricamento della pagina corrente scaricandolo, assicurandosi che il controllo visualizzi la versione più recente.

Vedi anche

Si applica a

Navigate(Uri)

Carica il documento nel percorso specificato dall'indicatore Uri nel controllo WebBrowser sostituendo il documento precedente.

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)

Parametri

url
Uri

Oggetto Uri che rappresenta l'URL del documento da caricare.

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

ArgumentException

Il valore del parametro url non rappresenta un URI assoluto. Per altre informazioni, vedere IsAbsoluteUri.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il Navigate metodo per implementare una barra degli indirizzi per il WebBrowser controllo . In questo esempio è necessario che il form contenga un WebBrowser controllo denominato , un TextBox controllo denominato webBrowser1TextBoxAddresse un Button controllo denominato 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. Quando si naviga facendo clic su un collegamento ipertestuale, la casella di testo viene aggiornata automaticamente per visualizzare l'URL corrente.

Per l'esempio di codice completo, vedere Procedura: Aggiungere funzionalità del Web browser a un'applicazione Windows Form.

// 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 mantiene un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione. Quando si chiama questo overload, il WebBrowser controllo passa all'URI specificato e lo aggiunge alla fine dell'elenco di cronologia. Utilizzare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo lo spostamento indietro.

Il WebBrowser controllo archivia le pagine Web dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il Refresh metodo per forzare il WebBrowser ricaricamento della pagina corrente scaricandolo, assicurandosi che il controllo visualizzi la versione più recente.

È possibile utilizzare il Navigate metodo per implementare una barra degli indirizzi simile a quella 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.

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.

Eccezioni

ObjectDisposedException

Questa istanza di WebBrowser non è più valida.

InvalidOperationException

Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

Commenti

Il WebBrowser controllo mantiene un elenco di cronologia di tutte le pagine Web visitate durante una sessione di esplorazione. Quando si chiama questo overload, il WebBrowser controllo passa all'URI specificato e lo aggiunge alla fine dell'elenco di cronologia. Utilizzare il GoBack metodo per restituire il controllo a una pagina precedente nella cronologia di navigazione. Usare il GoForward metodo per tornare a una pagina successiva nella cronologia di navigazione dopo lo spostamento indietro.

Il WebBrowser controllo archivia le pagine Web dai siti visitati di recente in una cache sul disco rigido locale. Ogni pagina può specificare una data di scadenza che indica per quanto tempo rimarrà nella cache. Quando il controllo passa a una pagina, consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il Refresh metodo per forzare il WebBrowser ricaricamento della pagina corrente scaricandolo, assicurandosi che il controllo visualizzi la versione più recente.

È possibile utilizzare il Navigate metodo per implementare una barra degli indirizzi simile a quella in Internet Explorer.

Vedi anche

Si applica a