NavigationService.Navigate Método

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

Devoluções

true se uma navegação não for cancelada; caso contrário, false.

Observações

Este método destina-se apenas a aplicações autónomas e a conteúdos da Extensible Application Markup Language (XAML).

Este método apresenta o mesmo comportamento do NavigationService.Navigate, e estende-o garantindo que o conteúdo que está a ser descarregado é colocado numa sandbox de segurança de confiança parcial (com o conjunto padrão de permissões da zona Internet - ver WPF Segurança de Confiança Parcial).

Ver também

• Navigate(Uri)
• Navigate(Uri, Object)
• Navigate(Object)
• Navigate(Object, Object)

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

Devoluções

true se uma navegação não for cancelada; caso contrário, false.

Exemplos

O exemplo seguinte demonstra a navegação até um URI e a passagem do 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

Observações

Como as navegações são assíncronas, é possível que várias navegações estejam em curso ao mesmo tempo. Por exemplo, se houver dois frames filhos numa única página, ambos podem estar a navegar. Neste caso, os vários eventos de navegação que NavigationService são gerados podem ser levantados várias vezes, um para cada conteúdo a que se está a navegar, e não necessariamente pela ordem em que as navegações foram solicitadas. Consequentemente, se um determinado pedido de navegação precisar de processar dados específicos para o pedido individual, não pode utilizar dados disponíveis para todos os pedidos de navegação. Em vez disso, pode usar navigationState para passar dados de processamento de navegação específicos de um pedido 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 Navigated, NavigationStopped, LoadCompleted gestores de eventos).

Ver também

• Navigate(Uri)
• Navigate(Uri, Object, Boolean)
• Navigate(Object)
• Navigate(Object, Object)

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

Devoluções

true se uma navegação não for cancelada; caso contrário, false.

Exemplos

O exemplo seguinte mostra como navegar até 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

Observações

O valor de pode ser uma URL Web ou um URI de pacote válido (ver Pack em WPF).

Navigate navegará até ao URI especificado por source se as seguintes condições forem verdadeiras:

• O Navigating evento não foi cancelado.

• Pode ser criado um pedido web (ver Navigating).

Se source for null, o conteúdo existente (Content) é limpo.

Podes usar Navigate para navegar até um fragmento de conteúdo. Se o conteúdo identificado pelo URI for o conteúdo atual, não é descarregado novamente.

Ver também

• Navigate(Uri, Object)
• Navigate(Uri, Object, Boolean)
• Navigate(Object)
• Navigate(Object, Object)

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

Devoluções

true se uma navegação não for cancelada; caso contrário, false.

Exemplos

O exemplo seguinte 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

Observações

Navigate irá navegar até ao Object especificado por root se as seguintes condições forem verdadeiras:

• O Navigating evento não foi cancelado.

• Pode ser criado um pedido web (ver Navigating).

Se root for null, o conteúdo existente (Content) é limpo.

Ver também

• Navigate(Uri)
• Navigate(Uri, Object)
• Navigate(Uri, Object, Boolean)
• Navigate(Object, Object)

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

Devoluções

true se uma navegação não for cancelada; caso contrário, false.

Exemplos

O exemplo seguinte mostra como navegar até um Page objeto que contém o conteúdo de origem e como 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

Observações

Este método tem o mesmo comportamento que NavigationService.Navigate, embora um objeto seja passado em vez de um URI.

Ver também

• Navigate(Uri)
• Navigate(Uri, Object)
• Navigate(Uri, Object, Boolean)
• Navigate(Object)