WebBrowserNavigatingEventArgs Класс

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет данные о событии 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)

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

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