NavigationService.Navigate Methode

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

Parameter

Gibt zurück

true, wenn eine Navigation nicht abgebrochen wurde, andernfalls false.

Hinweise

Diese Methode ist nur für eigenständige Anwendungen und XAML-Inhalte (Extensible Application Markup Language) vorgesehen.

Diese Methode weist das gleiche Verhalten wie NavigationService.Navigateauf und erweitert es, indem sichergestellt wird, dass der heruntergeladene Inhalt in eine Teilweise vertrauenswürdige Sicherheitssandbox eingefügt wird (mit dem Standardmäßigen Internetzonen-Berechtigungssatz – siehe WPF Partial Trust Security).

Weitere Informationen

• 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

Parameter

Gibt zurück

true, wenn eine Navigation nicht abgebrochen wurde, andernfalls false.

Beispiele

Im folgenden Beispiel wird das Navigieren zu einem URI und das Übergeben des Navigationszustands veranschaulicht.

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

Hinweise

Da Navigationen asynchron sind, ist es möglich, dass mehrere Navigationen gleichzeitig ausgeführt werden. Wenn z. B. zwei untergeordnete Frames auf einer einzelnen Seite vorhanden sind, können beide Frames navigieren. In diesem Fall können die verschiedenen Navigationsereignisse, die von NavigationService ausgelöst werden, mehrmals ausgelöst werden, eines für jeden Inhaltsabschnitt, zu dem navigiert wird, und nicht notwendigerweise in der Reihenfolge, in der die Navigationen angefordert wurden. Wenn also eine bestimmte Navigationsanforderung Daten verarbeiten muss, die für die einzelne Anforderung spezifisch sind, kann sie keine Daten verwenden, die für alle Navigationsanforderungen verfügbar sind. Stattdessen können Sie verwenden navigationState , um Daten für die Navigationsverarbeitung zu übergeben, die spezifisch für eine Navigationsanforderung ist.

Die folgenden Ereignisargumente ermöglichen den Zugriff auf den Navigationszustand:

• ExtraData (wird an das Navigating Ereignis übergeben).

• ExtraData (wird an die NavigatedEreignishandler , NavigationStopped, LoadCompleted übergeben).

Weitere Informationen

• 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

Parameter

Gibt zurück

true, wenn eine Navigation nicht abgebrochen wurde, andernfalls false.

Beispiele

Das folgende Beispiel zeigt, wie Sie zu einem URI navigieren.

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

Hinweise

Der Wert von source kann eine Web-URL oder ein gültiger Paket-URI sein (siehe Pack-URIs in WPF).

Navigate navigiert zu dem von angegebenen source URI, wenn die folgenden Bedingungen zutreffen:

• Das Navigating Ereignis wird nicht abgebrochen.

• Eine Webanforderung (siehe Navigating) kann erstellt werden.

Wenn source ist null, wird der vorhandene Inhalt (Content) gelöscht.

Sie können verwenden Navigate , um zu einem Inhaltsfragment zu navigieren. Wenn der durch den URI identifizierte Inhalt der aktuelle Inhalt ist, wird er nicht erneut heruntergeladen.

Weitere Informationen

• 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

Parameter

Gibt zurück

true, wenn eine Navigation nicht abgebrochen wurde, andernfalls false.

Beispiele

Das folgende Beispiel zeigt, wie Sie zu einem Page Objekt navigieren, das die Quellinhaltsstruktur enthält.

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

Hinweise

Navigate navigiert zu der Object angegebenen von root , wenn die folgenden Bedingungen zutreffen:

• Das Navigating Ereignis wird nicht abgebrochen.

• Eine Webanforderung (siehe Navigating) kann erstellt werden.

Wenn root ist null, wird der vorhandene Inhalt (Content) gelöscht.

Weitere Informationen

• 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

Parameter

Gibt zurück

true, wenn eine Navigation nicht abgebrochen wurde, andernfalls false.

Beispiele

Das folgende Beispiel zeigt, wie Sie zu einem Page Objekt navigieren, das den Quellinhalt enthält, und den Navigationszustand übergeben.

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

Hinweise

Diese Methode hat das gleiche Verhalten wie NavigationService.Navigate, obwohl ein -Objekt anstelle eines URI übergeben wird.

Weitere Informationen

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