Questa documentazione è stata archiviata e non viene gestita.

Evento WebBrowser.Navigated

Aggiornamento: novembre 2007

Si verifica quando il controllo WebBrowser si è spostato su un nuovo documento e ha iniziato a caricarlo.

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

public event WebBrowserNavigatedEventHandler Navigated
/** @event */
public void add_Navigated (WebBrowserNavigatedEventHandler value)
/** @event */
public void remove_Navigated (WebBrowserNavigatedEventHandler value)

JScript non supporta gli eventi.

Il controllo WebBrowser viene posizionato su un nuovo documento ogni volta che viene impostata una delle seguenti proprietà o che viene chiamato uno dei metodi seguenti:

Gestire l'evento Navigated in modo da ricevere notifica quando il controllo WebBrowser si è spostato su un nuovo documento. Quando si verifica l'evento Navigated, il caricamento del nuovo documento è iniziato e quindi è possibile accedere al contenuto caricato tramite le proprietà Document, DocumentText e DocumentStream. Gestire l'evento DocumentCompleted in modo da ricevere una notifica quando il controllo WebBrowser ha terminato di caricare il documento.

È possibile ricevere notifica anche prima che lo spostamento abbia inizio mediante la gestione dell'evento Navigating. La gestione di questo evento consente di annullare lo spostamento se non si sono verificate determinate condizioni, ad esempio se l'utente non ha ancora completato un form.

Per ulteriori informazioni sulla gestione di eventi, vedere Utilizzo degli eventi.

Nell'esempio di codice riportato di seguito, viene illustrato come utilizzare un gestore per l'evento Navigated 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: