Questa documentazione è stata archiviata e non viene gestita.

Metodo WebBrowser.Navigate (Uri)

Aggiornamento: novembre 2007

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

Spazio dei nomi:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public void Navigate(
	Uri url
)
public void Navigate(
	Uri url
)
public function Navigate(
	url : Uri
)

Parametri

url
Tipo: System.Uri

Uri che rappresenta l'URL del documento da caricare.

EccezioneCondizione
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 ulteriori informazioni, vedere Uri.IsAbsoluteUri.

Nel controllo WebBrowser è contenuto un elenco della cronologia di tutte le pagine Web visitate durante una sessione di esplorazione. Quando viene chiamato questo overload, il controllo WebBrowser viene posizionato sull'URL specificato, che viene aggiunto alla fine dell'elenco della cronologia. Utilizzare il metodo GoBack per spostare nuovamente il controllo su una pagina precedente della cronologia degli spostamenti. Utilizzare il metodo GoForward per ritornare a una pagina successiva della cronologia degli spostamenti dopo uno spostamento indietro.

Il controllo WebBrowser archivia le pagine Web di siti visitati di recente in una cache sul disco rigido locale. In ogni pagina può essere specificata una data di scadenza che indica per quanto tempo rimarrà nella cache. Quando ci si sposta su una pagina, il controllo consente di risparmiare tempo visualizzando una versione memorizzata nella cache, se disponibile, anziché scaricare nuovamente la pagina. Utilizzare il metodo Refresh per forzare il controllo WebBrowser a ricaricare la pagina corrente eseguendone il download per assicurare la visualizzazione della versione più recente.

Il metodo Navigate può essere utilizzato per implementare una barra degli indirizzi con caratteristiche analoghe a quello di Internet Explorer.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo Navigate per implementare una barra degli indirizzi per il controllo WebBrowser. Per eseguire questo esempio è necessario che il form utilizzato contenga un controllo WebBrowser denominato webBrowser1, un controllo TextBox denominato TextBoxAddress e un controllo Button denominato ButtonGo. Quando si digita un URL nella casella di testo e si preme INVIO o si sceglie il pulsante Vai, l'URL specificato viene visualizzato dal controllo WebBrowser. Quando si effettua uno spostamento facendo clic su un collegamento ipertestuale, la casella di testo viene aggiornata automaticamente con l'URL corrente.

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

// 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();
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0

.NET Compact Framework

Supportato in: 3.5, 2.0
Mostra: