WebBrowser.Navigate Metodo
Definizione
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 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 -> unitPublic Sub Navigate (url As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)Parametri
- 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
Questa istanza di WebBrowser non è più valida.
Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.
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 -> unitPublic 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
Questa istanza di WebBrowser non è più valida.
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 -> unitPublic Sub Navigate (url As Uri, newWindow As Boolean)Parametri
- newWindow
- Boolean
true per caricare il documento in una nuova finestra del browser; false per caricare il documento nel controllo WebBrowser.
Eccezioni
Questa istanza di WebBrowser non è più valida.
Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.
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 -> unitPublic Sub Navigate (url As Uri, targetFrameName As String)Parametri
- targetFrameName
- String
Nome del frame nel quale caricare il documento.
Eccezioni
Questa istanza di WebBrowser non è più valida.
Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.
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 -> unitPublic 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
Questa istanza di WebBrowser non è più valida.
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 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(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 -> unitPublic 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
Questa istanza di WebBrowser non è più valida.
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)
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 -> unitPublic Sub Navigate (url As Uri)Parametri
Eccezioni
Questa istanza di WebBrowser non è più valida.
Non è stato possibile recuperare un riferimento a un'implementazione dell'interfaccia IWebBrowser2 dal controllo ActiveX WebBrowser sottostante.
Il valore del parametro url non rappresenta un URI assoluto. Per altre informazioni, vedere IsAbsoluteUri.
Esempio
Nell'esempio di codice seguente viene illustrato come usare il Navigate metodo per implementare una barra degli indirizzi per il WebBrowser controllo. In questo esempio è necessario che il modulo contenga un controllo denominato webBrowser1, un TextBox controllo denominato TextBoxAddresse un Button controllo denominato ButtonGo.WebBrowser Quando si digita un URL nella casella di testo e si preme INVIO o si fa clic sul pulsante Go , il WebBrowser controllo passa all'URL specificato. Quando si passa facendo clic su un collegamento ipertestuale, la casella di testo aggiorna automaticamente per visualizzare l'URL corrente.
Per l'esempio di codice completo, vedere Procedura: 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 gestisce un elenco di cronologie 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 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.
È possibile usare 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 -> unitPublic Sub Navigate (urlString As String)Parametri
- urlString
- String
URL del documento da caricare.
Eccezioni
Questa istanza di WebBrowser non è più valida.
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 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 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.
È possibile usare il Navigate metodo per implementare una barra degli indirizzi simile a quella in Internet Explorer.
Vedi anche
Si applica a
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per