NavigationService Klasse

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
NavigationService

Hinweise

NavigationServicekapselt die Möglichkeit zum Herunterladen von Inhalt innerhalb des Kontexts einer Navigation im Browser Stil.NavigationService encapsulates the ability to download content within the context of a browser-style navigation.

Der Inhalt kann eine beliebige Art von .NET Framework Objekt und HTML-Dateien sein.Content can be any type of .NET Framework object and HTML files. Im Allgemeinen werden jedoch Seiten als Methode zum Verpacken von Inhalten für die Navigation bevorzugt (siehe Page).In general, however, pages are the preferred as the way to package content for navigation (see Page).

Der Inhalt kann aufgerufen werden, indem eine Instanz eines-Objekts bereitgestellt und eine Überladung der Navigate -Methode aufgerufen wird, die 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 können Sie auf den Navigate Inhalt navigieren, indem Sie einen relativen oder absoluten URI an eine der Methoden Überladungen übergeben, die einen URI akzeptieren: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 durch den URI navigiert wird NavigationService , gibt 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 bei jeder Navigation ausgelöst. der Satz von Ereignissen, die ausgelöst werden, wird durch den Typ der Navigation (Inhalts-oder Inhalts Fragmente) und die Beendigung der Navigation (abgebrochen, beendet oder fehlgeschlagen) bestimmt.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 Reihenfolge, in der diese Ereignisse ausgelöst werden:The following figure illustrates the sequence in which these events are raised:

![Flussdiagramm für die Seitennavigation] (~/add/media/navigationoverviewfigure11.png "Flussdiagramm für die Seitennavigation")Page navigation flow chart

NavigationService Bietet während oder nach einer Navigation Informationen zu dem Inhalt, zu dem navigiert wird, einschließlich des URI der Inhalte, zu denen navigiert wird (Source), des URI des aktuellen Inhalts (CurrentSource) und eines Objekts, das das Inhalt, zu dem navigiert wurdeContent().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 zu navigiert wird, NavigationService zeichnet die Navigation als Eintrag im Navigationsverlauf auf.When content is navigated to, NavigationService records the navigation as an entry in navigation history. Der Rück Navigationsverlauf wird ein Eintrag hinzugefügt, wenn eine neue Navigation durchgeführt wird, Navigate indem die-Methode aufgerufen wird, oder indem Sie zu einem Eintrag im vorwärts GoForwardNavigationsverlauf navigieren, indem Sie aufrufen.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. Zum vorwärts Navigationsverlauf wird ein Eintrag hinzugefügt, indem Sie zu einem Eintrag im Navigationsverlauf zurück navigieren GoBack, indem Sie aufrufen.An entry is added to forward navigation history by navigating to an entry in back navigation history, by calling GoBack. CanGoBackund CanGoForward melden, ob Einträge im Navigationsverlauf zurück bzw. vorwärts vorhanden sind.CanGoBack and CanGoForward report whether there are entries in back and forward navigation history, respectively. Außerdem kann der letzte Eintrag im rückwärts Navigationsverlauf durch Aufrufen RemoveBackEntryvon entfernt werden.Also, the most recent entry in back navigation history can be removed by calling RemoveBackEntry.

Standardmäßig NavigationService speichert keine Instanz eines Inhalts Objekts im Navigationsverlauf.By default, NavigationService does not store an instance of a content object in navigation history. NavigationService Stattdessen erstellt bei jedem navigieren zu mithilfe des Navigations Verlaufs eine neue Instanz des Inhalts Objekts.Instead, NavigationService creates a new instance of the content object each time it is navigated to by using navigation history. Dieses Verhalten ist so konzipiert, dass eine übermäßige Arbeitsspeicher Nutzung vermieden wird, wenn eine große Anzahl von Inhalten und große Teile des Inhalts navigiert werden.This behavior is designed to avoid excessive memory consumption when large numbers and large pieces of content are being navigated to. Folglich wird der Zustand des Inhalts nicht von einer Navigation zum nächsten gespeichert.Consequently, the state of the content is not remembered from one navigation to the next. WPF bietet jedoch mehrere Techniken, mit denen Sie einen Teil des Zustands 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 AddBackEntryvon können Sie auch mehrere Sätze von Zuständen für eine einzelne Seiten Instanz merken.Using AddBackEntry, you can also remember multiple sets of state for a single page instance.

NavigationServiceist eine sealed -Klasse und kann daher nicht instanziiert werden. NavigationService stattdessen wird von Navigatoren verwendet, um die Navigation zu aktivieren.NavigationService is a sealed class and therefore cannot be instantiated; instead, NavigationService is used by navigators to enable navigation. In WPF gibt es zwei Navigatoren: NavigationWindow und. FrameIn WPF, there are two navigators: NavigationWindow and Frame.

Visuell können XBAPsXBAPs Sie Internet Explorer 7Internet Explorer 7 als Navigator verwenden, um eine integrierte Benutzerfunktion bereitzustellen.Visually, XBAPsXBAPs use Internet Explorer 7Internet Explorer 7 as a navigator, to provide an integrated user experience. XBAPsXBAPs Tatsächlich wird jedoch als Navigator verwendet NavigationWindow MainWindow Internet Explorer 7Internet Explorer 7 NavigationWindow. die-Eigenschaft eines-Objekts, das in ausgeführtwird,gibteinenVerweisaufdenunddenNavigationsverlaufzurück,dervomXBAPXBAP ist in den von Internet Explorer 7Internet Explorer 7 verwalteten Navigationsverlauf integriert: NavigationWindowPhysically, 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 Navigate XBAPXBAP der Inhalt durch Aufrufen von, GoBack GoForward aufgerufen wird, werden die relevanten Navigations Verlaufs Einträge auch dem Internet Explorer 7Internet Explorer 7 Navigationsverlauf hinzugefügt.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 werden, Internet Explorer 7Internet Explorer 7 bewirkt NavigationService , dass zurück zu dem Inhalt navigiert, der 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 kann einen eigenen Navigationsverlauf bereitstellen oder den Navigationsverlauf des Navigators verwenden, der ihn hostet.A Frame can provide its own navigation history, or use the navigation history of the navigator that hosts it. Wenn Frame einen eigenen Navigationsverlauf bereitstellt, kann eine eigene Navigation UIUI angezeigt werden, um durch die Einträge im Navigationsverlauf zu navigieren. diese Einträge werden dem Navigationsverlauf des Host Navigators nichtNavigationWindowhinzugefügt (, Frame UIUI , Internet ExplorerInternet Explorer) und können daher nicht von der Navigation aus navigiert werden (siehe 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

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

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

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

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

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)

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)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
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()

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

(Geerbt von Object)
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()

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

MemberwiseClone()

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

(Geerbt von 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)

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)

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

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)

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()

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

RemoveBackEntry()

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

StopLoading()

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

ToString()

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

(Geerbt von Object)

Ereignisse

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

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

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

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

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

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

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: