WebBrowserNavigatingEventArgs Classe

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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é rempli. 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 qu’il ne commence si certaines conditions n’ont pas été remplies, par exemple, lorsque l’utilisateur n’a pas rempli complètement un formulaire. Pour ce faire, définissez la Cancel propriété de l’objet WebBrowserNavigatingEventArgs passé au gestionnaire d’événements sur true. 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

WebBrowserNavigatingEventArgs(Uri, String)

Initialise une nouvelle instance de la classe WebBrowserNavigatingEventArgs.

Propriétés

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 la page Web dans lequel le nouveau document sera chargé.
Url

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

Méthodes

Equals(Object)

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

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

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

(Hérité de Object)

S’applique à

Voir aussi