JournalEntry Classe

Définition

Espace de noms:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Représente une entrée dans l'historique de navigation avant ou arrière.

public ref class JournalEntry : System::Windows::DependencyObject, System::Runtime::Serialization::ISerializable

public class JournalEntry : System.Windows.DependencyObject, System.Runtime.Serialization.ISerializable

type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Héritage

Object

DispatcherObject

DependencyObject

JournalEntry

Implémente

ISerializable

Exemples

L’exemple suivant montre comment récupérer l’objet le plus récent JournalEntry de la pile de navigation arrière pour obtenir les valeurs de propriété Name et Source .

void removeJournalEntryButton_Click(object sender, RoutedEventArgs e)
{
    // If there are journal entries on the back navigation stack
    if (this.NavigationService.CanGoBack)
    {
        // Remove and get the most recent entry on the back navigation stack
        JournalEntry journalEntry = this.NavigationService.RemoveBackEntry();

        string name = journalEntry.Name;
        string uri = journalEntry.Source.OriginalString;
        MessageBox.Show(name + " [" + uri + "] removed from back navigation.");
    }
}

Private Sub removeJournalEntryButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' If there are journal entries on the back navigation stack
    If Me.NavigationService.CanGoBack Then
        ' Remove and get the most recent entry on the back navigation stack
        Dim journalEntry As JournalEntry = Me.NavigationService.RemoveBackEntry()

        Dim name As String = journalEntry.Name
        Dim uri As String = journalEntry.Source.OriginalString
        MessageBox.Show(name & " [" & uri & "] removed from back navigation.")
    End If
End Sub

Remarques

Windows Presentation Foundation implémente un service d’historique de navigation qui stocke une entrée pour chaque élément de contenu qui a été précédemment accédé, tout comme l’historique de navigation dans un navigateur. L’historique de navigation comprend deux piles, l’une qui mémorise l’historique de navigation vers l’arrière et l’autre qui mémorise l’historique de navigation avant.

Une entrée pour l’élément actif est ajoutée à l’historique de navigation arrière lorsqu’une navigation vers l’avant se produit. Cela se produit dans les situations suivantes :

• La Navigate méthode est appelée (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• La GoForward méthode est appelée (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Bouton suivant de l’interface utilisateur de navigation affiché à partir du navigateur actuel (XBAP, NavigationWindow, Frame).

De même, une entrée pour l’élément actif est ajoutée à l’historique de navigation avant qu’une navigation vers l’arrière ne se produise, ce qui se produit dans les cas suivants :

• La GoBack méthode est appelée (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Bouton Précédent de l’interface utilisateur de navigation affiché à partir du navigateur actuel (XBAP, NavigationWindow, Frame).

Chaque entrée dans l’historique de navigation arrière et avant est une instance de la JournalEntry classe.

Chaque JournalEntry objet encapsule des informations sur une navigation particulière, y compris un nom pour l’entrée (Name), si l’entrée est maintenue active (KeepAlive) et l’IDENTIFICATEUR de ressource uniforme (URI) pour le contenu qui est accédé à (Source).

Vous pouvez récupérer tous les objets dans l’historique JournalEntry de navigation arrière en énumérant les NavigationWindow.BackStack propriétés ou Frame.BackStack . Pour l’historique de navigation vers l’avant, vous pouvez récupérer tous les JournalEntry objets en énumérant les NavigationWindow.ForwardStack propriétés ou Frame.ForwardStack .

Si vous devez supprimer l’objet le plus récent JournalEntry de l’historique de navigation arrière, pour empêcher la navigation vers celui-ci, par exemple, vous pouvez appeler la RemoveBackEntry méthode (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), qui supprime l’objet JournalEntry et retourne une référence à celui-ci.

Toutefois, vous ne pouvez pas ajouter JournalEntry d’objets à l’historique de navigation, car vous ne pouvez ni instancier ni dériver de JournalEntry, et parce qu’aucun type n’implémente un membre pour le faire. Toutefois, vous pouvez ajouter des objets personnalisés CustomContentState à l’historique de navigation arrière en appelant la AddBackEntry méthode (AddBackEntry, AddBackEntry, AddBackEntry). NavigationService ajoute l’objet CustomContentState à un objet créé JournalEntry en interne, qui est ensuite ajouté à l’historique de navigation arrière.

Constructeurs

JournalEntry(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe JournalEntry.

Champs

KeepAliveProperty	Identifie la propriété jointe KeepAlive.
NameProperty	Identifie la propriété jointe Name.

Propriétés

CustomContentState	Obtient ou définit l'objet CustomContentState associé à cette entrée de journal.
DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de ce instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)
Name	Obtient ou définit le nom de l'entrée de journal.
Source	Obtient ou définit l'URI du contenu accédé.

Propriétés attachées

KeepAlive

Obtient ou définit une valeur qui indique si le contenu d'une entrée de journal est conservé ou recréé lorsqu'il est accédé dans l'historique de navigation.

Méthodes

CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. (Hérité de DependencyObject)
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetKeepAlive(DependencyObject)	Retourne la propriété jointe KeepAlive de l’entrée de journal correspondant à l’élément spécifié.
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetName(DependencyObject)	Obtient la propriété jointe Name de l’entrée de journal correspondant à l’élément spécifié.
GetObjectData(SerializationInfo, StreamingContext)	Appelé lorsque cet objet est sérialisé.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	Définit la propriété jointe KeepAlive de l’élément spécifié.
SetName(DependencyObject, String)	Définit la propriété jointe Name de l’élément spécifié.
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)