NavigationService.Navigate Metodo

Definizione

Spazio dei nomi:
System.Windows.Navigation
Assembly:
PresentationFramework.dll

Passare in modo asincrono al contenuto di origine specificato.

Overload

Nome Descrizione
Navigate(Uri, Object, Boolean)

Passare in modo asincrono al contenuto di origine situato in un URI, passare un oggetto contenente lo stato di navigazione per l'elaborazione durante la navigazione e sandbox il contenuto.
Navigate(Uri, Object)

Passare in modo asincrono al contenuto di origine situato in un URI e passare un oggetto contenente i dati da usare per l'elaborazione durante la navigazione.
Navigate(Uri)

Passare in modo asincrono al contenuto specificato da un URI.
Navigate(Object)

Passare in modo asincrono al contenuto contenuto da un oggetto .
Navigate(Object, Object)

Passare in modo asincrono al contenuto contenuto da un oggetto e passare un oggetto contenente i dati da utilizzare per l'elaborazione durante la navigazione.

Navigate(Uri, Object, Boolean)

Passare in modo asincrono al contenuto di origine situato in un URI, passare un oggetto contenente lo stato di navigazione per l'elaborazione durante la navigazione e sandbox il contenuto.

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

Parametri

source
Uri

Oggetto Uri inizializzato con l'URI per il contenuto desiderato.

navigationState
Object

Oggetto contenente i dati da utilizzare per l'elaborazione durante la navigazione.

sandboxExternalContent
Boolean

Scaricare il contenuto in una sandbox di sicurezza parzialmente attendibile (con il set predefinito di autorizzazioni dell'area Internet, se true. Il valore predefinito è false.

Valori restituiti

Boolean

true se una navigazione non viene annullata; in caso contrario, false.

Commenti

Questo metodo è solo per le applicazioni autonome e il contenuto XAML (Extensible Application Markup Language).

Questo metodo presenta lo stesso comportamento di NavigationService.Navigatee lo estende assicurando che il contenuto scaricato venga inserito in una sandbox di sicurezza parzialmente attendibile (con il set di autorizzazioni predefinito dell'area Internet. Vedere Sicurezza parzialmente attendibile WPF).

Vedi anche

Si applica a

Navigate(Uri, Object)

Passare in modo asincrono al contenuto di origine situato in un URI e passare un oggetto contenente i dati da usare per l'elaborazione durante la navigazione.

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

Parametri

source
Uri

Oggetto Uri inizializzato con l'URI per il contenuto desiderato.

navigationState
Object

Oggetto contenente i dati da utilizzare per l'elaborazione durante la navigazione.

Valori restituiti

Boolean

true se una navigazione non viene annullata; in caso contrario, false.

Esempio

Nell'esempio seguente viene illustrato lo spostamento a un URI e il passaggio dello stato di spostamento.

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

Commenti

Poiché gli spostamenti sono asincroni, è possibile che più spostamenti siano in corso contemporaneamente. Ad esempio, se in una singola pagina sono presenti due fotogrammi figlio, entrambi i fotogrammi potrebbero spostarsi. In questo caso, i vari eventi di spostamento generati da NavigationService possono essere generati più volte, uno per ogni parte di contenuto a cui viene eseguito lo spostamento e non necessariamente nell'ordine in cui sono stati richiesti gli spostamenti. Di conseguenza, se una particolare richiesta di navigazione deve elaborare dati specifici per la singola richiesta, non può usare i dati disponibili per tutte le richieste di navigazione. È invece possibile usare navigationState per passare i dati per l'elaborazione della navigazione specifica di una richiesta di navigazione.

Gli argomenti dell'evento seguenti forniscono l'accesso allo stato di navigazione:

Vedi anche

Si applica a

Navigate(Uri)

Passare in modo asincrono al contenuto specificato da un URI.

public:
 bool Navigate(Uri ^ source);
public bool Navigate(Uri source);
member this.Navigate : Uri -> bool
Public Function Navigate (source As Uri) As Boolean

Parametri

source
Uri

Oggetto Uri inizializzato con l'URI per il contenuto desiderato.

Valori restituiti

Boolean

true se una navigazione non viene annullata; in caso contrario, false.

Esempio

Nell'esempio seguente viene illustrato come passare a un 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

Commenti

Il valore di source può essere un URL Web o un URI di pacchetto valido (vedere URI pack in WPF).

Navigate passerà all'URI specificato da source se le condizioni seguenti sono vere:

  • L'evento Navigating non viene annullato.

  • È possibile creare una richiesta Web (vedere Navigating).

Se source è null, il contenuto esistente (Content) viene cancellato.

Note

Quando si scarica il contenuto Web, è possibile che venga visualizzata un'eccezione Web (ad esempio, 404: File non trovato). È possibile gestire tali eccezioni da NavigationFailed.

È possibile usare Navigate per passare a un frammento di contenuto. Se il contenuto identificato dall'URI è il contenuto corrente, non viene scaricato di nuovo.

Vedi anche

Si applica a

Navigate(Object)

Passare in modo asincrono al contenuto contenuto da un oggetto .

public:
 bool Navigate(System::Object ^ root);
public bool Navigate(object root);
member this.Navigate : obj -> bool
Public Function Navigate (root As Object) As Boolean

Parametri

root
Object

Oggetto contenente il contenuto a cui passare.

Valori restituiti

Boolean

true se una navigazione non viene annullata; in caso contrario, false.

Esempio

Nell'esempio seguente viene illustrato come passare a un Page oggetto contenente l'albero del contenuto di origine.

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

Commenti

Navigate passerà all'oggetto Object specificato da root se le condizioni seguenti sono vere:

  • L'evento Navigating non viene annullato.

  • È possibile creare una richiesta Web (vedere Navigating).

Se root è null, il contenuto esistente (Content) viene cancellato.

Note

Quando si scarica il contenuto Web, è possibile che venga visualizzata un'eccezione Web (ad esempio, 404: File non trovato). È possibile gestire tali eccezioni da NavigationFailed.

Vedi anche

Si applica a

Navigate(Object, Object)

Passare in modo asincrono al contenuto contenuto da un oggetto e passare un oggetto contenente i dati da utilizzare per l'elaborazione durante la navigazione.

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

Parametri

root
Object

Oggetto contenente il contenuto a cui passare.

navigationState
Object

Oggetto contenente i dati da utilizzare per l'elaborazione durante la navigazione.

Valori restituiti

Boolean

true se una navigazione non viene annullata; in caso contrario, false.

Esempio

Nell'esempio seguente viene illustrato come passare a un Page oggetto contenente il contenuto di origine e passare lo stato di spostamento.

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

Commenti

Questo metodo ha lo stesso comportamento di NavigationService.Navigate, anche se viene passato un oggetto anziché un URI.

Vedi anche

Si applica a