Поделиться через

WebBrowserNavigatingEventArgs Класс

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll
Исходный код:
WebBrowserNavigatingEventArgs.cs
Исходный код:
WebBrowserNavigatingEventArgs.cs
Исходный код:
WebBrowserNavigatingEventArgs.cs
Исходный код:
WebBrowserNavigatingEventArgs.cs
Исходный код:
WebBrowserNavigatingEventArgs.cs

Предоставляет данные для события Navigating.

public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits CancelEventArgs
Наследование
Object
EventArgs
CancelEventArgs
WebBrowserNavigatingEventArgs

Примеры

В следующем примере кода показано, как использовать обработчик события для WebBrowser.Navigating отмены навигации, когда форма веб-страницы не заполнена. Свойство WebBrowser.Document используется для определения того, содержит ли поле ввода формы значение. В этом примере требуется, чтобы форма содержала WebBrowser элемент управления с именем 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

Комментарии

Событие WebBrowser.Navigating возникает перед WebBrowser переходом элемента управления к новому документу. Вы можете обработать это событие, чтобы отменить навигацию, прежде чем начать ее, если некоторые условия не выполнены, например, если пользователь не полностью заполнял форму. Для этого задайте Cancel свойству WebBrowserNavigatingEventArgs объекта, переданного обработчику trueсобытий. Этот объект также можно использовать для получения расположения нового документа с помощью Url свойства. Если новый документ будет отображаться в кадре веб-страницы, можно получить имя кадра через TargetFrameName свойство.

Конструкторы

Имя Описание
WebBrowserNavigatingEventArgs(Uri, String)

Инициализирует новый экземпляр класса WebBrowserNavigatingEventArgs.

Свойства

Имя Описание
Cancel

Возвращает или задает значение, указывающее, следует ли отменить событие.

(Унаследовано от CancelEventArgs)
TargetFrameName

Возвращает имя кадра веб-страницы, в котором будет загружен новый документ.
Url

Возвращает расположение документа, в котором WebBrowser находится элемент управления.

Методы

Имя Описание
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел