WebBrowser.Navigated Événement

Définition

Se produit lorsque le contrôle WebBrowser a navigué vers un nouveau document et a commencé à le charger.

public:
 event System::Windows::Forms::WebBrowserNavigatedEventHandler ^ Navigated;
public event System.Windows.Forms.WebBrowserNavigatedEventHandler Navigated;
public event System.Windows.Forms.WebBrowserNavigatedEventHandler? Navigated;
member this.Navigated : System.Windows.Forms.WebBrowserNavigatedEventHandler 
Public Custom Event Navigated As WebBrowserNavigatedEventHandler 
Public Event Navigated As WebBrowserNavigatedEventHandler 

Type d'événement

Exemples

L’exemple de code suivant montre comment utiliser un gestionnaire pour l’événement Navigated afin d’implémenter une barre d’adresse pour le WebBrowser contrôle. Cet exemple nécessite que votre formulaire contienne un WebBrowser contrôle appelé webBrowser1, un TextBox contrôle appelé TextBoxAddresset un Button contrôle appelé ButtonGo. Lorsque vous tapez une URL dans la zone de texte et que vous appuyez sur ENTRÉE ou cliquez sur le bouton Atteindre , le WebBrowser contrôle accède à l’URL spécifiée. Lorsque vous naviguez en cliquant sur un lien hypertexte, la zone de texte est automatiquement mise à jour pour afficher l’URL actuelle.

Pour obtenir l’exemple de code complet, consultez Guide pratique pour ajouter des fonctionnalités de navigateur web à une application 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

Remarques

Le WebBrowser contrôle accède à un nouveau document chaque fois qu’une des propriétés suivantes est définie ou que des méthodes sont appelées :

Gérez l’événement Navigated pour recevoir une notification lorsque le WebBrowser contrôle a accédé à un nouveau document. Lorsque l’événement Navigated se produit, le nouveau document a commencé à être chargé, ce qui signifie que vous pouvez accéder au contenu chargé via les Documentpropriétés , DocumentTextet DocumentStream . Gérez l’événement DocumentCompleted pour recevoir une notification lorsque le WebBrowser contrôle termine le chargement du nouveau document.

Vous pouvez également recevoir une notification avant le début de la navigation en gérant l’événement Navigating . La gestion de cet événement vous permet d’annuler la navigation si certaines conditions ne sont pas remplies, par exemple, si l’utilisateur n’a pas rempli complètement un formulaire.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

S’applique à

Voir aussi