WebBrowser.Navigated Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando o WebBrowser controlo navegou para um novo documento e começou a carregá-lo.
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 Tipo de Evento
Exemplos
O exemplo de código seguinte demonstra como usar um handler para o Navigated evento implementar uma barra de endereços para o WebBrowser controlo. Este exemplo exige que a sua forma contenha um WebBrowser controlo chamado webBrowser1, um TextBox controlo chamado TextBoxAddress, e um Button controlo chamado ButtonGo. Quando escreve um URL na caixa de texto e pressiona ENTER ou clica no botão Go , o controlo WebBrowser navega até ao URL especificado. Quando navega clicando num hiperlink, a caixa de texto atualiza-se automaticamente para mostrar o URL atual.
Para o exemplo completo do código, veja Como: Adicionar Capacidades de Navegador Web a uma Aplicação Windows Forms.
// 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
Observações
O WebBrowser controlo navega para um novo documento sempre que uma das seguintes propriedades ou métodos é chamada:
Trate do Navigated evento para receber notificações quando o WebBrowser controlo tiver navegado para um novo documento. Quando o Navigated evento ocorre, o novo documento já começou a carregar, o que significa que pode aceder ao conteúdo carregado através das Documentpropriedades , DocumentText, e DocumentStream . Trate do DocumentCompleted evento para receber notificação quando o WebBrowser controlo terminar de carregar o novo documento.
Também pode receber notificações antes do início da navegação, ao tratar do Navigating evento. Gerir este evento permite cancelar a navegação se certas condições não forem cumpridas, por exemplo, o utilizador não tiver preenchido completamente um formulário.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.
