WebBrowser.Navigate Metodo

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Carica il documento nella posizione specificata nel WebBrowser controllo .

Overload

Nome	Descrizione
Navigate(Uri, String, Byte[], String)	Carica il documento nel percorso indicato dall'oggetto specificato Uri nel WebBrowser controllo, richiedendolo utilizzando i dati HTTP specificati e sostituendo il contenuto del frame di pagina Web con il nome specificato.
Navigate(String, String, Byte[], String)	Carica il documento in corrispondenza dell'URL (Uniform Resource Locator) specificato nel WebBrowser controllo, richiedendolo usando i dati HTTP specificati e sostituendo il contenuto del frame di pagina Web con il nome specificato.
Navigate(Uri, Boolean)	Carica il documento nella posizione indicata dall'oggetto specificato Uri in una nuova finestra del browser o nel WebBrowser controllo .
Navigate(Uri, String)	Carica il documento nella posizione indicata dall'oggetto specificato Uri nel WebBrowser controllo, sostituendo il contenuto della cornice della pagina Web con il nome specificato.
Navigate(String, Boolean)	Carica il documento in corrispondenza dell'URL (Uniform Resource Locator) specificato in una nuova finestra del browser o nel WebBrowser controllo .
Navigate(String, String)	Carica il documento in corrispondenza dell'URL (Uniform Resource Locator) specificato nel WebBrowser controllo, sostituendo il contenuto del frame di pagina Web con il nome specificato.
Navigate(Uri)	Carica il documento nella posizione indicata dall'oggetto specificato Uri nel WebBrowser controllo, sostituendo il documento precedente.
Navigate(String)	Carica il documento in corrispondenza dell'URL (Uniform Resource Locator) specificato nel WebBrowser controllo, sostituendo il documento precedente.

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

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Carica il documento nel percorso indicato dall'oggetto specificato Uri nel WebBrowser controllo, richiedendolo utilizzando i dati HTTP specificati e sostituendo il contenuto del frame di 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 in cui caricare il documento.

postData: Byte[]

Dati HTTP POST, ad esempio dati del modulo.

additionalHeaders: String

Intestazioni HTTP da aggiungere alle intestazioni predefinite.

Eccezioni

ObjectDisposedException

Questa WebBrowser istanza non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

ArgumentException

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

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 in corrispondenza dell'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 di nuovo la pagina. Utilizzare il Refresh metodo per forzare il WebBrowser controllo a ricaricare la pagina corrente scaricandola, assicurandosi che il controllo visualizzi la versione più recente.

Vedi anche

Si applica a

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

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Carica il documento in corrispondenza dell'URL (Uniform Resource Locator) specificato nel WebBrowser controllo, richiedendolo usando i dati HTTP specificati e sostituendo il contenuto del frame di 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 in cui caricare il documento.

postData: Byte[]

Dati HTTP POST, ad esempio dati del modulo.

additionalHeaders: String

Intestazioni HTTP da aggiungere alle intestazioni predefinite.

Eccezioni

ObjectDisposedException

Questa WebBrowser istanza non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

Commenti

Vedi anche

Si applica a

Navigate(Uri, Boolean)

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Carica il documento nella posizione indicata dall'oggetto specificato Uri in una nuova finestra del browser o nel WebBrowser controllo .

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 WebBrowser controllo .

Eccezioni

ObjectDisposedException

Questa WebBrowser istanza non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

ArgumentException

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

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 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 valore di parametro newWindow di true, il controllo WebBrowser carica il documento nell'URI specificato in una nuova finestra di Internet Explorer, che mantiene la propria cronologia di navigazione. È 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 di nuovo la pagina. Utilizzare il Refresh metodo per forzare il WebBrowser controllo a ricaricare la pagina corrente scaricandola, 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 Refresh.

Vedi anche

Si applica a

Navigate(Uri, String)

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Carica il documento nella posizione indicata dall'oggetto specificato Uri nel WebBrowser controllo, sostituendo il contenuto della cornice 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 in cui caricare il documento.

Eccezioni

ObjectDisposedException

Questa WebBrowser istanza non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

ArgumentException

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

Commenti

Vedi anche

Si applica a

Navigate(String, Boolean)

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Carica il documento in corrispondenza dell'URL (Uniform Resource Locator) specificato in una nuova finestra del browser o nel WebBrowser controllo .

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 WebBrowser controllo .

Eccezioni

ObjectDisposedException

Questa WebBrowser istanza non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

Commenti

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 di nuovo la pagina. Utilizzare il Refresh metodo per forzare il WebBrowser controllo a ricaricare la pagina corrente scaricandola, 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 Refresh.

Vedi anche

Si applica a

Navigate(String, String)

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Carica il documento in corrispondenza dell'URL (Uniform Resource Locator) specificato nel WebBrowser controllo, sostituendo il contenuto del frame di 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 in cui caricare il documento.

Eccezioni

ObjectDisposedException

Questa WebBrowser istanza non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

Commenti

Vedi anche

Si applica a

Navigate(Uri)

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Carica il documento nella posizione indicata dall'oggetto specificato Uri nel WebBrowser controllo, 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 WebBrowser istanza non è più valida.

InvalidOperationException

Impossibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.

ArgumentException

Il valore del url parametro 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 controllo denominato WebBrowser, un webBrowser1 controllo denominato TextBoxe un TextBoxAddress controllo denominato Button.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 passa 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 Come aggiungere funzionalità del Web browser a un'applicazione 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

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.

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

Vedi anche

Si applica a

Navigate(String)

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Origine:: WebBrowser.cs

Carica il documento in corrispondenza dell'URL (Uniform Resource Locator) specificato nel WebBrowser controllo, 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 WebBrowser istanza non è più valida.

InvalidOperationException

Impossibile 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.

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

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?