JournalEntry Clase

Definición

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

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

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

[<System.Serializable>]
type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Herencia

Object

DispatcherObject

DependencyObject

JournalEntry

Atributos

SerializableAttribute

Implementaciones

ISerializable

Ejemplos

En el ejemplo siguiente se muestra cómo recuperar el objeto más reciente JournalEntry de la pila de navegación inversa para obtener los valores de propiedad Name y 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

Comentarios

Windows Presentation Foundation implementa un servicio de historial de navegación que almacena una entrada para cada elemento de contenido al que se ha navegado anteriormente, al igual que el historial de navegación en un explorador. El historial de navegación consta de dos pilas, una que recuerda el historial de navegación hacia atrás y otra que recuerda el historial de navegación hacia delante.

Cuando se produce una navegación hacia delante, se agrega una entrada para el elemento actual al historial de navegación posterior. Esto ocurre en las situaciones siguientes:

• Se Navigate llama al método (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• Se GoForward llama al método (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Botón hacia delante de la interfaz de usuario de navegación que se muestra desde el navegador actual (XBAP, NavigationWindow, Frame).

Del mismo modo, se agrega una entrada para el elemento actual para reenviar el historial de navegación antes de que se produzca una navegación inversa, lo que sucede cuando:

• Se GoBack llama al método (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Botón Atrás de la interfaz de usuario de navegación que se muestra desde el navegador actual (XBAP, NavigationWindow, Frame).

Cada entrada del historial de navegación hacia atrás y hacia delante es una instancia de la JournalEntry clase .

Cada JournalEntry objeto encapsula información sobre una navegación determinada, incluido un nombre para la entrada (Name), si la entrada se mantiene activa (KeepAlive) y el identificador uniforme de recursos (URI) para el contenido al que se navega (Source).

Puede recuperar todos los JournalEntry objetos del historial de navegación posterior mediante la enumeración de las NavigationWindow.BackStack propiedades o Frame.BackStack . Para el historial de navegación hacia delante, puede recuperar todos los objetos mediante la JournalEntry enumeración de las NavigationWindow.ForwardStack propiedades o Frame.ForwardStack .

Si necesita quitar el objeto más reciente JournalEntry del historial de navegación atrás, para evitar la navegación a él, por ejemplo, puede llamar al RemoveBackEntry método (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), que quita el JournalEntry objeto y devuelve una referencia a él.

Sin embargo, no se pueden agregar JournalEntry objetos al historial de navegación, ya que no se pueden crear instancias ni derivar de JournalEntry, y porque ningún tipo implementa un miembro para hacerlo. Sin embargo, puede agregar objetos personalizados CustomContentState al historial de navegación posterior llamando al AddBackEntry método (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService agrega el CustomContentState objeto a un objeto creado JournalEntry internamente, que luego se agrega al historial de navegación posterior.

Constructores

Campos

Propiedades

Propiedades adjuntas

Métodos

Se aplica a