NavigationService.Navigate Methode

  • Referenz

Definition

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

Navigiert asynchron zum angegebenen Quellinhalt.

Überlädt

Navigate(Uri, Object, Boolean)

Navigiert asynchron zum Quellinhalt am URI, übergibt ein Objekt mit dem Navigationszustand für die Verarbeitung während der Navigation und stellt eine Sandboxumgebung für den Inhalt bereit.
Navigate(Uri, Object)

Navigiert asynchron zum Quellinhalt am URI und übergibt ein Objekt mit Daten, die für die Verarbeitung während der Navigation verwendet werden.
Navigate(Uri)

Navigiert asynchron zu dem Inhalt, der durch einen URI angegeben wird.
Navigate(Object)

Navigiert asynchron zu Inhalt, der in einem Objekt enthalten ist.
Navigate(Object, Object)

Navigiert asynchron zu Inhalt in einem Objekt und übergibt ein Objekt mit Daten, die für die Verarbeitung während der Navigation verwendet werden.

Navigate(Uri, Object, Boolean)

Navigiert asynchron zum Quellinhalt am URI, übergibt ein Objekt mit dem Navigationszustand für die Verarbeitung während der Navigation und stellt eine Sandboxumgebung für den Inhalt bereit.

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

source
Uri

Ein Uri-Objekt, das mit dem URI für den gewünschten Inhalt initialisiert wurde.

navigationState
Object

Ein Objekt, das Daten enthält, die für die Verarbeitung während der Navigation verwendet werden.

sandboxExternalContent
Boolean

Lädt Inhalt in eine teilweise vertrauenswürdige Sicherheits-Sandbox herunter (mit dem Standardberechtigungssatz der Internetzone, wenn true). Der Standardwert ist false.

Gibt zurück

Boolean

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

Gilt für:

Navigate(Uri, Object)

Navigiert asynchron zum Quellinhalt am URI und übergibt ein Objekt mit Daten, die für die Verarbeitung während der Navigation verwendet werden.

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

source
Uri

Ein Uri-Objekt, das mit dem URI für den gewünschten Inhalt initialisiert wurde.

navigationState
Object

Ein Objekt, das Daten enthält, die für die Verarbeitung während der Navigation verwendet werden.

Gibt zurück

Boolean

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:

Weitere Informationen

Gilt für:

Navigate(Uri)

Navigiert asynchron zu dem Inhalt, der durch einen URI angegeben wird.

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

Parameter

source
Uri

Ein Uri-Objekt, das mit dem URI für den gewünschten Inhalt initialisiert wurde.

Gibt zurück

Boolean

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.

Hinweis

Beim Herunterladen von Webinhalten erhalten Sie möglicherweise eine Web-Ausnahme (z. B. 404: Datei nicht gefunden). Sie können solche Ausnahmen von behandeln NavigationFailed.

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

Gilt für:

Navigate(Object)

Navigiert asynchron zu Inhalt, der in einem Objekt enthalten ist.

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

root
Object

Ein Objekt, das den Inhalt enthält, zu dem navigiert werden soll.

Gibt zurück

Boolean

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.

Hinweis

Beim Herunterladen von Webinhalten erhalten Sie möglicherweise eine Web-Ausnahme (z. B. 404: Datei nicht gefunden). Sie können solche Ausnahmen von behandeln NavigationFailed.

Weitere Informationen

Gilt für:

Navigate(Object, Object)

Navigiert asynchron zu Inhalt in einem Objekt und übergibt ein Objekt mit Daten, die für die Verarbeitung während der Navigation verwendet werden.

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

root
Object

Ein Objekt, das den Inhalt enthält, zu dem navigiert werden soll.

navigationState
Object

Ein Objekt, das Daten enthält, die für die Verarbeitung während der Navigation verwendet werden.

Gibt zurück

Boolean

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

Gilt für: