NavigationService.Navigate Método

  • Referência

Definição

Namespace:
System.Windows.Navigation
Assembly:
PresentationFramework.dll

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

source
Uri

Um objeto Uri inicializado com o URI para o conteúdo desejado.

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

Boolean

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

source
Uri

Um objeto Uri inicializado com o URI para o conteúdo desejado.

navigationState
Object

Um objeto que contém os dados a serem usados para processamento durante a navegação.

Retornos

Boolean

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:

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

source
Uri

Um objeto Uri inicializado com o URI para o conteúdo desejado.

Retornos

Boolean

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

Boolean

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

Boolean

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.

Confira também

Aplica-se a