NavigationService NavigationService NavigationService NavigationService Class

Definition

Enthält Methoden, Eigenschaften und Ereignisse zur Unterstützung der Navigation.Contains methods, properties, and events to support navigation.

public ref class NavigationService sealed
public sealed class NavigationService
type NavigationService = class
Public NotInheritable Class NavigationService
Vererbung
NavigationServiceNavigationServiceNavigationServiceNavigationService

Hinweise

NavigationService Kapselt die Möglichkeit, Inhalte innerhalb des Kontexts einer Navigation im Browserstil herunterzuladen.NavigationService encapsulates the ability to download content within the context of a browser-style navigation.

Inhalt kann jede Art von .NET Framework-Objekt und HTML-Dateien sein.Content can be any type of .NET Framework object and HTML files. Im Allgemeinen jedoch Seiten sind die bevorzugte als Weg zum Packen von Inhalten für die Navigation (finden Sie unter Page).In general, however, pages are the preferred as the way to package content for navigation (see Page).

Inhalt kann navigiert werden, indem Sie eine Instanz eines Objekts bereitzustellen und Aufruf einer Überladung der der Navigate -Methode, ein Objekt akzeptiert:Content can be navigated to by providing an instance of an object and calling an overload of the Navigate method that accepts an object:

Alternativ Inhalt kann navigiert werden, indem ein relativer oder absoluter URI an eine der übergeben der Navigate methodenüberladungen, die einen URI akzeptiert:Alternatively, content can be navigated to by passing a relative or absolute URI to one of the Navigate method overloads that accepts a URI:

Wenn der Inhalt von URI, zu dem navigiert wird NavigationService ein Objekt zurück, das den Inhalt enthält.When content is navigated to by URI, NavigationService will return an object that contains the content.

Die Lebensdauer einer Navigation kann durch die folgenden Ereignisse nachverfolgt werden:The lifetime of a navigation can be tracked through the following events:

Nicht alle Ereignisse werden jedes Mal ausgelöst wird, die eine Navigation. der Satz von Ereignissen, die ausgelöst werden, richtet sich nach den Typ der Navigation, die (Inhalt oder -Fragment) tritt ein, und wie die Navigation abgeschlossen wurde (abgebrochen, beendet oder Fehler).Not all events are raised each time that a navigation occurs; the set of events that are raised is determined by the type of navigation that occurs (content or content fragment) and how the navigation completes (canceled, stopped, or failed).

Die folgende Abbildung veranschaulicht die Sequenz, die in der diese Ereignisse ausgelöst werden:The following figure illustrates the sequence in which these events are raised:

Seitennavigations-FlussdiagrammPage navigation flow chart

Während oder nach einer Navigation NavigationService enthält Informationen zum Inhalt, der zu dem navigiert wird einschließlich des URI des Inhalts, zu dem navigiert (Source), den URI des aktuellen Inhalts (CurrentSource), und ein Objekt mit dem Inhalt, zu dem navigiert wurde (Content).During or after a navigation, NavigationService provides information about the content that is being navigated to, including the URI of the content being navigated to (Source), the URI of the current content (CurrentSource), and an object that contains the content that was navigated to (Content).

Wenn Inhalt navigiert wird, NavigationService zeichnet die Navigation als einen Eintrag im Navigationsverlauf.When content is navigated to, NavigationService records the navigation as an entry in navigation history. Wird ein Eintrag hinzugefügt, dem Navigationsverlauf zurück, wenn eine neue Navigation, durch den Aufruf auftritt der Navigate -Methode, einen Eintrag im Navigationsverlauf vor, durch den Aufruf navigieren GoForward.An entry is added to back navigation history when either a new navigation occurs, by calling the Navigate method, or by navigating to an entry in forward navigation history, by calling GoForward. Durch Navigieren zu einem Eintrag im Navigationsverlauf, durch den Aufruf wird ein Eintrag zum Navigationsverlauf vor hinzugefügt GoBack.An entry is added to forward navigation history by navigating to an entry in back navigation history, by calling GoBack. CanGoBack und CanGoForward melden, ob es Einträge im Navigationsverlauf vor bzw. sind.CanGoBack and CanGoForward report whether there are entries in back and forward navigation history, respectively. Darüber hinaus den letzten Eintrag im Navigationsverlauf kann, durch den Aufruf entfernt werden RemoveBackEntry.Also, the most recent entry in back navigation history can be removed by calling RemoveBackEntry.

In der Standardeinstellung NavigationService keine Instanz eines Objekts mit Inhalt im Navigationsverlauf gespeichert.By default, NavigationService does not store an instance of a content object in navigation history. Stattdessen NavigationService erstellt eine neue Instanz der Content-Objekts, das jedes Mal indem über den Navigationsverlauf navigiert wird.Instead, NavigationService creates a new instance of the content object each time it is navigated to by using navigation history. Dieses Verhalten wurde entworfen, um eine übermäßige speichernutzung zu vermeiden, wenn eine große Anzahl und große Teile des Inhalts zu dem navigiert werden.This behavior is designed to avoid excessive memory consumption when large numbers and large pieces of content are being navigated to. Daher wird der Zustand des Inhalts nicht über eine Navigation zum nächsten gespeichert.Consequently, the state of the content is not remembered from one navigation to the next. WPF bietet jedoch verschiedene Techniken, die mit denen Sie einen gemeinsam genutzten Zustand für einen Inhalt im Navigationsverlauf speichern können.However, WPF provides several techniques by which you can store a piece of state for a piece of content in navigation history.

Mithilfe von AddBackEntry, Sie können auch mehrere Sätze von Status für eine Einzelseiten-Instanz speichern.Using AddBackEntry, you can also remember multiple sets of state for a single page instance.

NavigationService ist eine sealed Klasse, und deshalb nicht instanziiert werden; stattdessen NavigationService von Navigatoren verwendet, um die Navigation zu ermöglichen.NavigationService is a sealed class and therefore cannot be instantiated; instead, NavigationService is used by navigators to enable navigation. In WPF, es gibt zwei Navigatoren: NavigationWindow und Frame.In WPF, there are two navigators: NavigationWindow and Frame.

Visuell XBAPsXBAPs verwenden Internet Explorer 7Internet Explorer 7 als ein Navigator, um eine integrierte Benutzeroberfläche bereitzustellen.Visually, XBAPsXBAPs use Internet Explorer 7Internet Explorer 7 as a navigator, to provide an integrated user experience. Physisch jedoch XBAPsXBAPs verwende NavigationWindow als Navigator; die MainWindow Eigenschaft eine XBAPXBAP auf Internet Explorer 7Internet Explorer 7 gibt einen Verweis auf die NavigationWindow, und den Navigationsverlauf, die von verwaltet wird die NavigationWindow ist in den Navigationsverlauf, die von verwalteten integriert Internet Explorer 7Internet Explorer 7 auf folgende Weise:Physically, however, XBAPsXBAPs actually use NavigationWindow as the navigator; the MainWindow property of an XBAPXBAP running in Internet Explorer 7Internet Explorer 7 will return a reference to the NavigationWindow, and the navigation history that is managed by the NavigationWindow is integrated with the navigation history that is managed by Internet Explorer 7Internet Explorer 7 in the following ways:

  • Wenn Inhalt navigiert wird durch Aufrufen von Navigate, GoBack, und GoForward innerhalb einer XBAPXBAP der relevanten Einträge werden ebenfalls hinzugefügt, um Internet Explorer 7Internet Explorer 7 Navigationsverlauf.When content is navigated to by calling Navigate, GoBack, and GoForward from within an XBAPXBAP the relevant navigation history entries are also added to Internet Explorer 7Internet Explorer 7 navigation history.

  • Wenn Einträge in der Internet Explorer 7Internet Explorer 7 Navigation UIUI ausgewählt sind, Internet Explorer 7Internet Explorer 7 bewirkt, dass NavigationService zurück "oder" Vorwärts navigieren, auf den Inhalt, die von diesen Einträgen zugeordnet ist.When entries in the Internet Explorer 7Internet Explorer 7 navigation UIUI are selected, Internet Explorer 7Internet Explorer 7 causes NavigationService to navigate back or forwards to the content that is associated with those entries.

Hinweis

Ein Frame Geben Sie einen eigenen Navigationsverlauf können, oder verwenden Sie den Navigationsverlauf des der Navigator, der als Host dienende.A Frame can provide its own navigation history, or use the navigation history of the navigator that hosts it. Wenn Frame bietet einen eigenen Navigationsverlauf, können sie anzeigen, die eigene Navigations- UIUI zum Navigieren durch die Einträge im Navigationsverlauf; diese Einträge werden nicht zum Navigationsverlauf des Hostnavigators hinzugefügt (NavigationWindow, Frame, Internet ExplorerInternet Explorer) und, folglich kann nicht navigiert werden, bei der Navigation UIUI aller (finden Sie unter JournalOwnership).If Frame provides its own navigation history, it can display its own navigation UIUI to navigate through the entries in navigation history; those entries are not added to the navigation history of the host navigator (NavigationWindow, Frame, Internet ExplorerInternet Explorer) and, consequently, cannot be navigated to from the navigation UIUI of each (see JournalOwnership).

Eigenschaften

CanGoBack CanGoBack CanGoBack CanGoBack

Ruft einen Wert ab, der angibt, ob der Navigationsverlauf zurück mindestens einen Eintrag enthält.Gets a value that indicates whether there is at least one entry in back navigation history.

CanGoForward CanGoForward CanGoForward CanGoForward

Ruft einen Wert ab, der angibt, ob der Navigationsverlauf vor mindestens einen Eintrag enthält.Gets a value that indicates whether there is at least one entry in forward navigation history.

Content Content Content Content

Ruft einen Verweis auf das Objekt ab, das den aktuellen Inhalt enthält, oder legt diesen Verweis fest.Gets or sets a reference to the object that contains the current content.

CurrentSource CurrentSource CurrentSource CurrentSource

Ruft den URI des Inhalts ab, zu dem zuletzt navigiert wurde.Gets the URI of the content that was last navigated to.

Source Source Source Source

Ruft den URI des aktuellen Inhalts oder den URI des neuen Inhalts ab, zu dem zurzeit navigiert wird, oder legt diesen fest.Gets or sets the URI of the current content, or the URI of new content that is currently being navigated to.

Methoden

AddBackEntry(CustomContentState) AddBackEntry(CustomContentState) AddBackEntry(CustomContentState) AddBackEntry(CustomContentState)

Fügt einen Eintrag zum Navigationsverlauf zurück hinzu, der ein CustomContentState-Objekt enthält.Adds an entry to back navigation history that contains a CustomContentState object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetNavigationService(DependencyObject) GetNavigationService(DependencyObject) GetNavigationService(DependencyObject) GetNavigationService(DependencyObject)

Ruft einen Verweis auf den NavigationService für den Navigator ab, dessen Inhalt das angegebene DependencyObject enthält.Gets a reference to the NavigationService for the navigator whose content contains the specified DependencyObject.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GoBack() GoBack() GoBack() GoBack()

Navigiert zum letzten Eintrag im Navigationsverlauf zurück, sofern vorhanden.Navigates to the most recent entry in back navigation history, if there is one.

GoForward() GoForward() GoForward() GoForward()

Navigiert zum letzten Eintrag im Navigationsverlauf vor, sofern vorhanden.Navigate to the most recent entry in forward navigation history, if there is one.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Navigate(Object) Navigate(Object) Navigate(Object) Navigate(Object)

Navigiert asynchron zu Inhalt, der in einem Objekt enthalten ist.Navigate asynchronously to content that is contained by an object.

Navigate(Object, Object) Navigate(Object, Object) Navigate(Object, Object) 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 asynchronously to content that is contained by an object, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri) Navigate(Uri) Navigate(Uri) Navigate(Uri)

Navigiert asynchron zu dem Inhalt, der durch einen URI angegeben wird.Navigate asynchronously to content that is specified by a URI.

Navigate(Uri, Object) Navigate(Uri, Object) Navigate(Uri, Object) 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 asynchronously to source content located at a URI, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) Navigate(Uri, Object, Boolean) 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 asynchronously to source content located at a URI, pass an object containing navigation state for processing during navigation, and sandbox the content.

Refresh() Refresh() Refresh() Refresh()

Lädt den aktuellen Inhalt erneut.Reloads the current content.

RemoveBackEntry() RemoveBackEntry() RemoveBackEntry() RemoveBackEntry()

Entfernt den letzten Journaleintrag aus dem Verlauf zurück.Removes the most recent journal entry from back history.

StopLoading() StopLoading() StopLoading() StopLoading()

Bricht das weitere Herunterladen von Inhalt für die aktuelle Navigationsanforderung ab.Stops further downloading of content for the current navigation request.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

FragmentNavigation FragmentNavigation FragmentNavigation FragmentNavigation

Tritt ein, wenn die Navigation zu einem Inhaltsfragment gestartet wird. Dies erfolgt sofort, wenn sich das gewünschte Fragment im aktuellen Inhalt befindet oder nachdem der XAMLXAML-Quellinhalt geladen wurde, sofern sich das gewünschte Fragment in einem anderen Inhalt befindet.Occurs when navigation to a content fragment begins, which occurs immediately, if the desired fragment is in the current content, or after the source XAMLXAML content has been loaded, if the desired fragment is in different content.

LoadCompleted LoadCompleted LoadCompleted LoadCompleted

Tritt ein, wenn der Inhalt, zu dem navigiert wird, geladen und analysiert und mit dem Rendering begonnen wurde.Occurs when content that was navigated to has been loaded, parsed, and has begun rendering.

Navigated Navigated Navigated Navigated

Tritt ein, wenn der Inhalt, zu dem navigiert wird, gefunden wurde. Dieses Ereignis ist über die Content-Eigenschaft verfügbar, auch wenn diese noch nicht vollständig geladen wurde.Occurs when the content that is being navigated to has been found, and is available from the Content property, although it may not have completed loading.

Navigating Navigating Navigating Navigating

Tritt ein, wenn eine neue Navigation angefordert wird.Occurs when a new navigation is requested.

NavigationFailed NavigationFailed NavigationFailed NavigationFailed

Tritt ein, wenn ein Fehler auftritt, während zum angeforderten Inhalt navigiert wird.Occurs when an error occurs while navigating to the requested content.

NavigationProgress NavigationProgress NavigationProgress NavigationProgress

Tritt regelmäßig während eines Downloadvorgangs auf, um Informationen zum Navigationsstatus bereitzustellen.Occurs periodically during a download to provide navigation progress information.

NavigationStopped NavigationStopped NavigationStopped NavigationStopped

Tritt ein, wenn die StopLoading()-Methode aufgerufen wird oder wenn eine neue Navigation angefordert wird, während eine aktuelle Navigation noch ausgeführt wird.Occurs when the StopLoading() method is called, or when a new navigation is requested while a current navigation is in progress.

Gilt für: