WebBrowser.Navigated Событие

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

WebBrowser.cs

Происходит, когда WebBrowser элемент управления перейдет к новому документу и начал загружать его.

public:
 event System::Windows::Forms::WebBrowserNavigatedEventHandler ^ Navigated;

public event System.Windows.Forms.WebBrowserNavigatedEventHandler? Navigated;

member this.Navigated : System.Windows.Forms.WebBrowserNavigatedEventHandler 

Public Event Navigated As WebBrowserNavigatedEventHandler 

Тип события

WebBrowserNavigatedEventHandler

Примеры

В следующем примере кода показано, как использовать обработчик события для Navigated реализации адресной строки элемента WebBrowser управления. В этом примере требуется, чтобы форма содержала WebBrowser элемент управления , webBrowser1 называемый TextBoxэлемент TextBoxAddressуправления, а Button также называемый ButtonGoэлемент управления. При вводе URL-адреса в текстовое поле и нажатии клавиши ВВОД или нажатия кнопки WebBrowser элемент управления переходит к указанному URL-адресу. При переходе по гиперссылке текстовое поле автоматически обновляется для отображения текущего URL-адреса.

Полный пример кода см. в разделе How to: Add Web Browser Capabilities to a Windows Forms Application.

// Navigates to the URL in the address text box when 
// the ENTER key is pressed while the text box has focus.
void TextBoxAddress_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
{
   if ( e->KeyCode == System::Windows::Forms::Keys::Enter &&  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Navigates to the URL in the address text box when 
// the Go button is clicked.
void ButtonGo_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   if (  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Updates the URL in TextBoxAddress upon navigation.
void WebBrowser1_Navigated( Object^ /*sender*/, System::Windows::Forms::WebBrowserNavigatedEventArgs^ /*e*/ )
{
   this->TextBoxAddress->Text = this->WebBrowser1->Url->ToString();
}

// Navigates to the URL in the address box when 
// the ENTER key is pressed while the ToolStripTextBox has focus.
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Navigate(toolStripTextBox1.Text);
    }
}

// Navigates to the URL in the address box when 
// the Go button is clicked.
private void goButton_Click(object sender, EventArgs e)
{
    Navigate(toolStripTextBox1.Text);
}

// Navigates to the given URL if it is valid.
private void Navigate(String address)
{
    if (String.IsNullOrEmpty(address)) return;
    if (address.Equals("about:blank")) return;
    if (!address.StartsWith("http://") &&
        !address.StartsWith("https://"))
    {
        address = "http://" + address;
    }
    try
    {
        webBrowser1.Navigate(new Uri(address));
    }
    catch (System.UriFormatException)
    {
        return;
    }
}

// Updates the URL in TextBoxAddress upon navigation.
private void webBrowser1_Navigated(object sender,
    WebBrowserNavigatedEventArgs e)
{
    toolStripTextBox1.Text = webBrowser1.Url.ToString();
}

' Navigates to the URL in the address box when 
' the ENTER key is pressed while the ToolStripTextBox has focus.
Private Sub toolStripTextBox1_KeyDown( _
    ByVal sender As Object, ByVal e As KeyEventArgs) _
    Handles toolStripTextBox1.KeyDown

    If (e.KeyCode = Keys.Enter) Then
        Navigate(toolStripTextBox1.Text)
    End If

End Sub

' Navigates to the URL in the address box when 
' the Go button is clicked.
Private Sub goButton_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles goButton.Click

    Navigate(toolStripTextBox1.Text)

End Sub

' Navigates to the given URL if it is valid.
Private Sub Navigate(ByVal address As String)

    If String.IsNullOrEmpty(address) Then Return
    If address.Equals("about:blank") Then Return
    If Not address.StartsWith("http://") And _
        Not address.StartsWith("https://") Then
        address = "http://" & address
    End If

    Try
        webBrowser1.Navigate(New Uri(address))
    Catch ex As System.UriFormatException
        Return
    End Try

End Sub

' Updates the URL in TextBoxAddress upon navigation.
Private Sub webBrowser1_Navigated(ByVal sender As Object, _
    ByVal e As WebBrowserNavigatedEventArgs) _
    Handles webBrowser1.Navigated

    toolStripTextBox1.Text = webBrowser1.Url.ToString()

End Sub

Комментарии

Элемент WebBrowser управления переходит к новому документу при каждом вызове одного из следующих свойств или методов:

• Url
• DocumentText
• DocumentStream
• Navigate
• GoBack
• GoForward
• GoHome
• GoSearch

Обработайте Navigated событие для получения уведомлений, когда WebBrowser элемент управления перейдет к новому документу. Navigated При возникновении события новый документ начал загрузку, что означает, что вы можете получить доступ к загруженому содержимому с помощью Documentсвойств DocumentTextи DocumentStream свойств. Обработайте DocumentCompleted событие для получения уведомления, когда WebBrowser элемент управления завершит загрузку нового документа.

Вы также можете получать уведомления перед началом навигации Navigating , обрабатывая событие. Обработка этого события позволяет отменить навигацию, если некоторые условия не выполнены, например, пользователь не полностью заполнял форму.

Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".

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

• DocumentCompleted
• DocumentStream
• DocumentText
• GoBack()
• GoForward()
• GoHome()
• GoSearch()
• Navigate
• Navigating
• Url
• WebBrowserNavigatedEventArgs
• WebBrowserNavigatedEventHandler