WebBrowser.Navigated Événement

Définition

Se produit lorsque le contrôle WebBrowser a navigué vers un nouveau document et a commencé à le charger.Occurs when the WebBrowser control has navigated to a new document and has begun loading it.

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 

Exemples

L’exemple de code suivant montre comment utiliser un gestionnaire pour l' Navigated événement afin d’implémenter une barre d' WebBrowser adresses pour le contrôle.The following code example demonstrates how to use a handler for the Navigated event to implement an address bar for the WebBrowser control. Cet exemple suppose que votre formulaire contient un WebBrowser contrôle appelé webBrowser1, un TextBox contrôle TextBoxAddressappelé et un Button contrôle appelé ButtonGo.This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. Lorsque vous tapez une URL dans la zone de texte et appuyez sur entrée ou **** cliquez sur le bouton WebBrowser atteindre, le contrôle navigue vers l’URL spécifiée.When you type a URL into the text box and press ENTER or click the Go button, the WebBrowser control navigates to the URL specified. Lorsque vous naviguez en cliquant sur un lien hypertexte, la zone de texte est automatiquement mise à jour pour afficher l’URL actuelle.When you navigate by clicking a hyperlink, the text box automatically updates to display the current URL.

Pour obtenir un exemple de code complet , consultez Procédure: Ajoutez des fonctionnalités de navigateur Web à uneapplication Windows Forms.For the complete code example, see How to: Add Web Browser Capabilities to a Windows Forms Application.

// 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 navigue vers un nouveau document chaque fois que l’une des propriétés suivantes est définie ou que les méthodes sont appelées:The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:

Gérez l' Navigated événement pour recevoir une notification lorsque WebBrowser le contrôle a navigué vers un nouveau document.Handle the Navigated event to receive notification when the WebBrowser control has navigated to a new document. Lorsque l' Navigated événement se produit, le nouveau document a commencé le chargement, ce qui signifie que vous pouvez accéder au Documentcontenu chargé via DocumentStream les propriétés, DocumentTextet.When the Navigated event occurs, the new document has begun loading, which means you can access the loaded content through the Document, DocumentText, and DocumentStream properties. Gérez l' DocumentCompleted événement pour recevoir une notification lorsque WebBrowser le contrôle finit de charger le nouveau document.Handle the DocumentCompleted event to receive notification when the WebBrowser control finishes loading the new document.

Vous pouvez également recevoir des notifications avant le début de Navigating la navigation en gérant l’événement.You can also receive notification before navigation begins by handling the Navigating event. La gestion de cet événement vous permet d’annuler la navigation si certaines conditions n’ont pas été remplies, par exemple, si l’utilisateur n’a pas complètement rempli un formulaire.Handling this event lets you cancel navigation if certain conditions have not been met, for example, the user has not completely filled out a form.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

Sécurité

SecurityPermission
pour que les appelants immédiats utilisent ce contrôle.for immediate callers to use this control. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

S’applique à

Voir aussi