NavigationService.Navigate Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Navegue de maneira assíncrona para o conteúdo de origem especificado.
Sobrecargas
Navigate(Uri, Object, Boolean) |
Navegue de maneira assíncrona para conteúdo de origem localizado em um URI, passe um objeto que contém o estado de navegação para processamento durante a navegação e coloque o conteúdo na área restrita. |
Navigate(Uri, Object) |
Navegue de forma assíncrona para o conteúdo de origem localizado em um URI e passe um objeto que contém dados que serão usados para processamento durante a navegação. |
Navigate(Uri) |
Navegue de maneira assíncrona para o conteúdo que é especificado por um URI. |
Navigate(Object) |
Navegue de forma assíncrona para o conteúdo contido por um objeto. |
Navigate(Object, Object) |
Navegue de forma assíncrona o conteúdo contido por um objeto e passe um objeto que contém dados a serem usados para processamento durante a navegação. |
Navigate(Uri, Object, Boolean)
Navegue de maneira assíncrona para conteúdo de origem localizado em um URI, passe um objeto que contém o estado de navegação para processamento durante a navegação e coloque o conteúdo na área restrita.
public:
bool Navigate(Uri ^ source, System::Object ^ navigationState, bool sandboxExternalContent);
public bool Navigate (Uri source, object navigationState, bool sandboxExternalContent);
member this.Navigate : Uri * obj * bool -> bool
Public Function Navigate (source As Uri, navigationState As Object, sandboxExternalContent As Boolean) As Boolean
Parâmetros
- navigationState
- Object
Um objeto que contém os dados a serem usados para processamento durante a navegação.
- sandboxExternalContent
- Boolean
Baixe o conteúdo para uma área restrita de confiança parcial (com o conjunto de permissões padrão da zona da Internet), se true
. O padrão é false
.
Retornos
true
se uma navegação não tiver sido cancelada; caso contrário, false
.
Comentários
Esse método é apenas para aplicativos autônomos e conteúdo XAML (Extensible Application Markup Language).
Esse método exibe o mesmo comportamento NavigationService.Navigateque e o estende garantindo que o conteúdo que está sendo baixado seja colocado em uma área restrita de segurança de confiança parcial (com o conjunto padrão de permissões da zona da Internet – consulte Segurança de Confiança Parcial do WPF).
Confira também
Aplica-se a
Navigate(Uri, Object)
Navegue de forma assíncrona para o conteúdo de origem localizado em um URI e passe um objeto que contém dados que serão usados para processamento durante a navegação.
public:
bool Navigate(Uri ^ source, System::Object ^ navigationState);
public bool Navigate (Uri source, object navigationState);
member this.Navigate : Uri * obj -> bool
Public Function Navigate (source As Uri, navigationState As Object) As Boolean
Parâmetros
- navigationState
- Object
Um objeto que contém os dados a serem usados para processamento durante a navegação.
Retornos
true
se uma navegação não tiver sido cancelada; caso contrário, false
.
Exemplos
O exemplo a seguir demonstra como navegar para um URI e passar o estado de navegação.
void goButton_Click(object sender, RoutedEventArgs e)
{
this.NavigationService.Navigate(new Uri(this.addressTextBox.Text), DateTime.Now);
}
void NavigationService_LoadCompleted(object sender, NavigationEventArgs e)
{
DateTime requestDateTime = (DateTime)e.ExtraData;
string msg = string.Format("Request started {0}\nRequest completed {1}", requestDateTime, DateTime.Now);
MessageBox.Show(msg);
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text), Date.Now)
End Sub
Private Sub NavigationService_LoadCompleted(ByVal sender As Object, ByVal e As NavigationEventArgs)
Dim requestDateTime As Date = CDate(e.ExtraData)
Dim msg As String = String.Format("Request started {0}" & vbLf & "Request completed {1}", requestDateTime, Date.Now)
MessageBox.Show(msg)
End Sub
Comentários
Como as navegaçãos são assíncronas, é possível que várias navegaçãos estejam em andamento ao mesmo tempo. Por exemplo, se houver dois quadros filho em uma única página, ambos os quadros poderão estar navegando. Nesse caso, os vários eventos de navegação gerados por NavigationService podem ser gerados várias vezes, um para cada conteúdo que está sendo navegado e não necessariamente para que as navegaçãos tenham sido solicitadas. Consequentemente, se uma solicitação de navegação específica precisar processar dados específicos da solicitação individual, ela não poderá usar dados disponíveis para todas as solicitações de navegação. Em vez disso, você pode usar navigationState
para passar dados para processamento de navegação específicos de uma solicitação de navegação.
Os seguintes argumentos de evento fornecem acesso ao estado de navegação:
ExtraData (passado para o Navigating evento).
ExtraData(passado para os Navigatedmanipuladores de eventos , NavigationStopped). LoadCompleted
Confira também
Aplica-se a
Navigate(Uri)
Navegue de maneira assíncrona para o conteúdo que é especificado por um URI.
public:
bool Navigate(Uri ^ source);
public bool Navigate (Uri source);
member this.Navigate : Uri -> bool
Public Function Navigate (source As Uri) As Boolean
Parâmetros
Retornos
true
se uma navegação não tiver sido cancelada; caso contrário, false
.
Exemplos
O exemplo a seguir mostra como navegar para um URI.
void goButton_Click(object sender, RoutedEventArgs e)
{
this.NavigationService.Navigate(new Uri(this.addressTextBox.Text));
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text))
End Sub
Comentários
O valor de source
pode ser uma URL da Web ou um URI de pacote válido (consulte URIs do pacote no WPF).
Navigate navegará até o URI especificado por source
se as seguintes condições forem verdadeiras:
O Navigating evento não foi cancelado.
Uma solicitação da Web (consulte Navigating) pode ser criada.
Se source
for null
, o conteúdo existente (Content) será limpo.
Observação
Ao baixar conteúdo da Web, você pode receber uma exceção da Web (por exemplo, 404: Arquivo Não Encontrado). Você pode lidar com essas exceções de NavigationFailed.
Você pode usar Navigate para navegar até um fragmento de conteúdo. Se o conteúdo identificado pelo URI for o conteúdo atual, ele não será baixado novamente.
Confira também
Aplica-se a
Navigate(Object)
Navegue de forma assíncrona para o conteúdo contido por um objeto.
public:
bool Navigate(System::Object ^ root);
public bool Navigate (object root);
member this.Navigate : obj -> bool
Public Function Navigate (root As Object) As Boolean
Parâmetros
- root
- Object
Um objeto que contém o conteúdo para navegação.
Retornos
true
se uma navegação não tiver sido cancelada; caso contrário, false
.
Exemplos
O exemplo a seguir mostra como navegar até um Page objeto que contém a árvore de conteúdo de origem.
void goObjectButton_Click(object sender, RoutedEventArgs e)
{
this.NavigationService.Navigate(new ContentPage());
}
Private Sub goObjectButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
Me.NavigationService.Navigate(New ContentPage())
End Sub
Comentários
Navigate navegará até o Object especificado por root
se as seguintes condições forem verdadeiras:
O Navigating evento não foi cancelado.
Uma solicitação da Web (consulte Navigating) pode ser criada.
Se root
for null
, o conteúdo existente (Content) será limpo.
Observação
Ao baixar conteúdo da Web, você pode receber uma exceção da Web (por exemplo, 404: Arquivo Não Encontrado). Você pode lidar com essas exceções de NavigationFailed.
Confira também
Aplica-se a
Navigate(Object, Object)
Navegue de forma assíncrona o conteúdo contido por um objeto e passe um objeto que contém dados a serem usados para processamento durante a navegação.
public:
bool Navigate(System::Object ^ root, System::Object ^ navigationState);
public bool Navigate (object root, object navigationState);
member this.Navigate : obj * obj -> bool
Public Function Navigate (root As Object, navigationState As Object) As Boolean
Parâmetros
- root
- Object
Um objeto que contém o conteúdo para navegação.
- navigationState
- Object
Um objeto que contém os dados a serem usados para processamento durante a navegação.
Retornos
true
se uma navegação não tiver sido cancelada; caso contrário, false
.
Exemplos
O exemplo a seguir mostra como navegar até um Page objeto que contém o conteúdo de origem e passar o estado de navegação.
void goButton_Click(object sender, RoutedEventArgs e)
{
this.NavigationService.Navigate(new ContentPage(), DateTime.Now);
}
void NavigationService_LoadCompleted(object sender, NavigationEventArgs e)
{
DateTime requestDateTime = (DateTime)e.ExtraData;
string msg = string.Format("Request started {0}\nRequest completed {1}", requestDateTime, DateTime.Now);
MessageBox.Show(msg);
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
Me.NavigationService.Navigate(New ContentPage(), Date.Now)
End Sub
Private Sub NavigationService_LoadCompleted(ByVal sender As Object, ByVal e As NavigationEventArgs)
Dim requestDateTime As Date = CDate(e.ExtraData)
Dim msg As String = String.Format("Request started {0}" & vbLf & "Request completed {1}", requestDateTime, Date.Now)
MessageBox.Show(msg)
End Sub
Comentários
Esse método tem o mesmo comportamento que NavigationService.Navigate, embora um objeto seja passado em vez de um URI.