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


WebBrowserNavigatingEventArgs Класс

Определение

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

public ref class WebBrowserNavigatingEventArgs : System::ComponentModel::CancelEventArgs
public class WebBrowserNavigatingEventArgs : System.ComponentModel.CancelEventArgs
type WebBrowserNavigatingEventArgs = class
    inherit CancelEventArgs
Public Class WebBrowserNavigatingEventArgs
Inherits 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 элемента управления к новому документу. Это событие можно обработать, чтобы отменить навигацию до его начала, если не были выполнены определенные условия, например, когда пользователь не полностью заполнил форму. Для этого присвойте свойству CancelWebBrowserNavigatingEventArgs объекта , переданного обработчику 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)

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

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