Freigeben über


WebBrowser.Navigated Ereignis

Definition

Tritt ein, wenn das WebBrowser-Steuerelement zu einem neuen Dokument navigiert ist und mit dem Laden des Dokuments begonnen hat.

public:
 event System::Windows::Forms::WebBrowserNavigatedEventHandler ^ Navigated;
public event System.Windows.Forms.WebBrowserNavigatedEventHandler Navigated;
public event System.Windows.Forms.WebBrowserNavigatedEventHandler? Navigated;
member this.Navigated : System.Windows.Forms.WebBrowserNavigatedEventHandler 
Public Custom Event Navigated As WebBrowserNavigatedEventHandler 
Public Event Navigated As WebBrowserNavigatedEventHandler 

Ereignistyp

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen Handler für das Navigated Ereignis verwenden, um eine Adressleiste für das WebBrowser Steuerelement zu implementieren. In diesem Beispiel muss das Formular ein WebBrowser -Steuerelement mit dem Namen webBrowser1, ein TextBox -Steuerelement mit dem Namen TextBoxAddressund ein Button -Steuerelement mit dem Namen ButtonGoenthält. Wenn Sie eine URL in das Textfeld eingeben und die EINGABETASTE drücken oder auf die Schaltfläche Go klicken, navigiert das WebBrowser Steuerelement zu der angegebenen URL. Wenn Sie durch Klicken auf einen Link navigieren, wird das Textfeld automatisch aktualisiert, um die aktuelle URL anzuzeigen.

Das vollständige Codebeispiel finden Sie unter Vorgehensweise: Hinzufügen von Webbrowserfunktionen zu einer Windows Forms-Anwendung.

// 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

Hinweise

Das WebBrowser Steuerelement navigiert immer dann zu einem neuen Dokument, wenn eine der folgenden Eigenschaften festgelegt oder Methoden aufgerufen werden:

Behandeln Sie das Navigated Ereignis, um eine Benachrichtigung zu erhalten, wenn das WebBrowser Steuerelement zu einem neuen Dokument navigiert hat. Wenn das Navigated Ereignis auftritt, hat das neue Dokument mit dem Laden begonnen. Dies bedeutet, dass Sie über die Eigenschaften , DocumentTextund DocumentStream auf den Documentgeladenen Inhalt zugreifen können. Behandeln Sie das DocumentCompleted Ereignis, um eine Benachrichtigung zu erhalten, wenn das WebBrowser Steuerelement das Laden des neuen Dokuments abgeschlossen hat.

Sie können auch eine Benachrichtigung erhalten, bevor die Navigation beginnt, indem Sie das Navigating Ereignis behandeln. Wenn Sie dieses Ereignis behandeln, können Sie die Navigation abbrechen, wenn bestimmte Bedingungen nicht erfüllt wurden, z. B. wenn der Benutzer ein Formular nicht vollständig ausgefüllt hat.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Weitere Informationen