WebBrowser.Navigated Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

WebBrowser.cs

Nastane, když ovládací WebBrowser prvek přejde do nového dokumentu a začne ho načítat.

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 

Event Type

WebBrowserNavigatedEventHandler

Příklady

Následující příklad kódu ukazuje, jak použít obslužnou rutinu Navigated pro událost implementovat adresní řádek pro WebBrowser ovládací prvek. Tento příklad vyžaduje, aby formulář obsahuje WebBrowser ovládací prvek s názvem , webBrowser1 s TextBoxnázvem TextBoxAddressovládacího prvku a Button s názvem ButtonGoovládacího prvku . Když do textového pole zadáte adresu URL a stisknete enter nebo kliknete na tlačítko Přejít , WebBrowser ovládací prvek přejde na zadanou adresu URL. Když přejdete kliknutím na hypertextový odkaz, textové pole se automaticky aktualizuje, aby se zobrazila aktuální adresa URL.

Úplný příklad kódu najdete v tématu How to: Add Web Browser Capabilities to a model 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

Poznámky

Ovládací WebBrowser prvek přejde na nový dokument pokaždé, když je nastavena jedna z následujících vlastností nebo je volána metoda:

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

Navigated Zpracování události pro příjem oznámení, když WebBrowser ovládací prvek přejde na nový dokument. Když dojde k Navigated události, nový dokument se začal načítat, což znamená, že k načteného obsahu můžete přistupovat prostřednictvím objektu Document, DocumentTexta DocumentStream vlastností. DocumentCompleted Zpracování události pro příjem oznámení, když WebBrowser ovládací prvek dokončí načtení nového dokumentu.

Před zahájením navigace můžete také obdržet oznámení tím, že Navigating se událost bude zpracovávat. Zpracování této události umožňuje zrušit navigaci, pokud nebyly splněny určité podmínky, například uživatel nevyplnil formulář úplně.

Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.

Viz také

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