Partager via

WebBrowserNavigatingEventArgs Classe

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
WebBrowserNavigatingEventArgs.cs
Source:
WebBrowserNavigatingEventArgs.cs
Source:
WebBrowserNavigatingEventArgs.cs
Source:
WebBrowserNavigatingEventArgs.cs
Source:
WebBrowserNavigatingEventArgs.cs

Fournit des données pour l’événement Navigating.

public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs
Héritage
Object
EventArgs
CancelEventArgs
WebBrowserNavigatingEventArgs

Exemples

L’exemple de code suivant montre comment utiliser un gestionnaire pour l’événement afin d’annuler la WebBrowser.Navigating navigation lorsqu’un formulaire de page web n’a pas été renseigné. La WebBrowser.Document propriété est utilisée pour déterminer si le champ d’entrée de formulaire contient une valeur. Cet exemple nécessite que votre formulaire contienne un WebBrowser contrôle appelé webBrowser1.

private void Form1_Load(object sender, EventArgs e)
{
    webBrowser1.DocumentText =
        "<html><body>Please enter your name:<br/>" +
        "<input type='text' name='userName'/><br/>" +
        "<a href='http://www.microsoft.com'>continue</a>" +
        "</body></html>";
    webBrowser1.Navigating += 
        new WebBrowserNavigatingEventHandler(webBrowser1_Navigating);
}

private void webBrowser1_Navigating(object sender, 
    WebBrowserNavigatingEventArgs e)
{
    System.Windows.Forms.HtmlDocument document =
        this.webBrowser1.Document;

    if (document != null && document.All["userName"] != null && 
        String.IsNullOrEmpty(
        document.All["userName"].GetAttribute("value")))
    {
        e.Cancel = true;
        System.Windows.Forms.MessageBox.Show(
            "You must enter your name before you can navigate to " +
            e.Url.ToString());
    }
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
    Handles Me.Load

    webBrowser1.DocumentText = _
        "<html><body>Please enter your name:<br/>" & _
        "<input type='text' name='userName'/><br/>" & _
        "<a href='http://www.microsoft.com'>continue</a>" & _
        "</body></html>"

End Sub

Private Sub webBrowser1_Navigating( _
    ByVal sender As Object, ByVal e As WebBrowserNavigatingEventArgs) _
    Handles webBrowser1.Navigating

    Dim document As System.Windows.Forms.HtmlDocument = _
        webBrowser1.Document
    If document IsNot Nothing And _
        document.All("userName") IsNot Nothing And _
        String.IsNullOrEmpty( _
        document.All("userName").GetAttribute("value")) Then

        e.Cancel = True
        MsgBox("You must enter your name before you can navigate to " & _
            e.Url.ToString())
    End If

End Sub

Remarques

L’événement WebBrowser.Navigating se produit avant que le WebBrowser contrôle accède à un nouveau document. Vous pouvez gérer cet événement pour annuler la navigation avant de commencer si certaines conditions n’ont pas été remplies, par exemple lorsque l’utilisateur n’a pas complètement rempli un formulaire. Pour ce faire, définissez la Cancel propriété de l’objet WebBrowserNavigatingEventArgs passé au gestionnaire d’événements truesur . Vous pouvez également utiliser cet objet pour récupérer l’emplacement du nouveau document via la Url propriété. Si le nouveau document s’affiche dans un cadre de page Web, vous pouvez récupérer le nom du cadre via la TargetFrameName propriété.

Constructeurs

Nom Description
WebBrowserNavigatingEventArgs(Uri, String)

Initialise une nouvelle instance de la classe WebBrowserNavigatingEventArgs.

Propriétés

Nom Description
Cancel

Obtient ou définit une valeur indiquant si l’événement doit être annulé.

(Hérité de CancelEventArgs)
TargetFrameName

Obtient le nom du cadre de page Web dans lequel le nouveau document sera chargé.
Url

Obtient l’emplacement du document vers lequel le WebBrowser contrôle navigue.

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi