NavigationService.Navigate Methode

Definition

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

Navigieren Sie asynchron zum angegebenen Quellinhalt.

Überlädt

Name Beschreibung
Navigate(Uri, Object, Boolean)

Navigieren Sie asynchron zu Quellinhalten, die sich an einem URI befinden, übergeben Sie ein Objekt, das den Navigationszustand für die Verarbeitung während der Navigation enthält, und sandkasten Sie den Inhalt.
Navigate(Uri, Object)

Navigieren Sie asynchron zu Quellinhalten, die sich in einem URI befinden, und übergeben Sie ein Objekt, das Daten enthält, die während der Navigation zur Verarbeitung verwendet werden sollen.
Navigate(Uri)

Navigieren Sie asynchron zu Inhalten, die von einem URI angegeben werden.
Navigate(Object)

Navigieren Sie asynchron zu Inhalten, die in einem Objekt enthalten sind.
Navigate(Object, Object)

Navigieren Sie asynchron zu Inhalten, die in einem Objekt enthalten sind, und übergeben Sie ein Objekt, das Daten enthält, die während der Navigation zur Verarbeitung verwendet werden sollen.

Navigate(Uri, Object, Boolean)

Navigieren Sie asynchron zu Quellinhalten, die sich an einem URI befinden, übergeben Sie ein Objekt, das den Navigationszustand für die Verarbeitung während der Navigation enthält, und sandkasten Sie den Inhalt.

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 während der Navigation zur Verarbeitung verwendet werden sollen.

sandboxExternalContent
Boolean

Herunterladen von Inhalten in eine teilweise vertrauenswürdige Sicherheits-Sandbox (mit dem standardmäßigen Internetzonensatz von Berechtigungen, wenn true. Der Standardwert lautet false.

Gibt zurück

Boolean

truewenn eine Navigation nicht abgebrochen wird; andernfalls . false

Hinweise

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

Diese Methode zeigt das gleiche Verhalten wie NavigationService.Navigate, und erweitert es, indem sichergestellt wird, dass der heruntergeladene Inhalt in eine teilweise vertrauenswürdige Sicherheits-Sandbox (mit dem Standardmäßigen Satz von Berechtigungen für die Internetzone - siehe WPF Partial Trust Security) platziert wird.

Weitere Informationen

Gilt für:

Navigate(Uri, Object)

Navigieren Sie asynchron zu Quellinhalten, die sich in einem URI befinden, und übergeben Sie ein Objekt, das Daten enthält, die während der Navigation zur Verarbeitung verwendet werden sollen.

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 während der Navigation zur Verarbeitung verwendet werden sollen.

Gibt zurück

Boolean

truewenn eine Navigation nicht abgebrochen wird; 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 beispielsweise zwei untergeordnete Frames auf einer einzelnen Seite vorhanden sind, könnten beide Frames navigieren. In diesem Fall können die verschiedenen Navigationsereignisse, die von NavigationService ihnen ausgelöst werden, mehrmals ausgelöst werden, eine für jeden Teil des Inhalts, zu dem navigiert wird, und nicht unbedingt in der Reihenfolge, in der die Navigation angefordert wurde. Wenn daher eine bestimmte Navigationsanforderung Daten verarbeiten muss, die für die individuelle Anforderung spezifisch sind, können keine Daten verwendet werden, die für alle Navigationsanforderungen verfügbar sind. Stattdessen können navigationState Sie Daten für die Navigationsverarbeitung übergeben, die spezifisch für eine Navigationsanforderung ist.

Die folgenden Ereignisargumente bieten Zugriff auf den Navigationszustand:

Weitere Informationen

Gilt für:

Navigate(Uri)

Navigieren Sie asynchron zu Inhalten, die von einem URI angegeben werden.

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

truewenn eine Navigation nicht abgebrochen wird; 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 kann source eine Web-URL oder ein gültiger Pack-URI sein (siehe Pack-URIs in WPF).

Navigate navigiert zu dem URI, der source angegeben wird, wenn die folgenden Bedingungen erfüllt sind:

  • Das Navigating Ereignis wird nicht abgebrochen.

  • Eine Webanforderung (siehe Navigating) kann erstellt werden.

Wenn source ja, wird nullder vorhandene Inhalt (Content) gelöscht.

Note

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

Sie können zum Navigieren zu einem Inhaltsfragment verwenden Navigate . Wenn der vom URI identifizierte Inhalt der aktuelle Inhalt ist, wird er nicht erneut heruntergeladen.

Weitere Informationen

Gilt für:

Navigate(Object)

Navigieren Sie asynchron zu Inhalten, die in einem Objekt enthalten sind.

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

truewenn eine Navigation nicht abgebrochen wird; 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 dem Object angegebenen root Wert, wenn die folgenden Bedingungen erfüllt sind:

  • Das Navigating Ereignis wird nicht abgebrochen.

  • Eine Webanforderung (siehe Navigating) kann erstellt werden.

Wenn root ja, wird nullder vorhandene Inhalt (Content) gelöscht.

Note

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

Weitere Informationen

Gilt für:

Navigate(Object, Object)

Navigieren Sie asynchron zu Inhalten, die in einem Objekt enthalten sind, und übergeben Sie ein Objekt, das Daten enthält, die während der Navigation zur Verarbeitung verwendet werden sollen.

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 während der Navigation zur Verarbeitung verwendet werden sollen.

Gibt zurück

Boolean

truewenn eine Navigation nicht abgebrochen wird; 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: