WebBrowser.Navigated Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn das WebBrowser Steuerelement zu einem neuen Dokument navigiert und mit dem Laden 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 ein Handler für das Navigated Ereignis verwendet wird, um eine Adressleiste für das WebBrowser Steuerelement zu implementieren. Dieses Beispiel erfordert, dass Ihr Formular ein Steuerelement enthält, das WebBrowser aufgerufen webBrowser1wird, ein TextBox Steuerelement, das aufgerufen TextBoxAddresswird, und ein Button Steuerelement, das aufgerufen wird ButtonGo. Wenn Sie eine URL in das Textfeld eingeben und die EINGABETASTE drücken oder auf die Schaltfläche " Gehe zu " 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 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
Hinweise
Das WebBrowser Steuerelement navigiert zu einem neuen Dokument, wenn eine der folgenden Eigenschaften festgelegt oder Methoden aufgerufen wird:
Behandeln Sie das Navigated Ereignis, um Benachrichtigungen zu erhalten, wenn das WebBrowser Steuerelement zu einem neuen Dokument navigiert wurde. Wenn das Navigated Ereignis eintritt, hat das neue Dokument mit dem Laden begonnen, was bedeutet, dass Sie über die Documentgeladenen DocumentTextInhalte und DocumentStream Eigenschaften auf den geladenen Inhalt zugreifen können. Behandeln Sie das DocumentCompleted Ereignis, um Benachrichtigungen zu erhalten, wenn das WebBrowser Steuerelement das Laden des neuen Dokuments beendet hat.
Sie können auch Benachrichtigungen empfangen, bevor die Navigation beginnt, indem Sie das Navigating Ereignis behandeln. Durch die Behandlung dieses Ereignisses können Sie die Navigation abbrechen, wenn bestimmte Bedingungen nicht erfüllt wurden, z. B. hat der Benutzer kein Formular vollständig ausgefüllt.
Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.
