¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
JournalEntry (Clase)

JournalEntry (Clase)

Actualización: noviembre 2007

Representa una entrada del historial de retroceso o de avance de navegación.

Espacio de nombres:  System.Windows.Navigation
Ensamblado:  PresentationFramework (en PresentationFramework.dll)

[SerializableAttribute]
public class JournalEntry : DependencyObject, 
	ISerializable
/** @attribute SerializableAttribute */ 
public class JournalEntry extends DependencyObject implements ISerializable
public class JournalEntry extends DependencyObject implements ISerializable
No se puede crear una instancia de esta clase directamente en XAML.

Windows Presentation Foundation (WPF) implementa un servicio del historial de navegación que almacena una entrada por cada parte del contenido al que se ha navegado previamente, como el historial de navegación de Microsoft Internet Explorer. El historial de navegación está formado por dos pilas, una que recuerda el historial de retroceso de navegación y otra, el de avance de navegación.

Se agrega una entrada por el elemento actual al historial de retroceso de navegación cuando se produce una navegación de avance. Esto se produce en las siguientes situaciones:

De igual forma, se agrega una entrada para el elemento actual al historial de avance de navegación antes de que se produzca una navegación de retroceso. Esto ocurre cuando:

Cada entrada del historial de avance y retroceso de navegación es una instancia de la clase JournalEntry.

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

Puede recuperar todos los objetos JournalEntry del historial de retroceso de navegación enumerando las propiedades NavigationWindow.BackStack o Frame.BackStack. En el historial de avance de navegación, puede recuperar todos los objetos JournalEntry enumerando las propiedades NavigationWindow.ForwardStack o Frame.ForwardStack.

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

No puede agregar objetos JournalEntry al historial de navegación, sin embargo, porque no puede crear instancias ni derivar desde JournalEntry, y porque ningún tipo implementa ningún miembro que lo haga. Sin embargo, puede agregar objetos CustomContentState personalizados al historial de retroceso de navegación llamando al método AddBackEntry (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService agrega el objeto CustomContentState a un objeto JournalEntry creado internamente, que después se agrega al historial de retroceso de navegación.

Para obtener un ejemplo que use CustomContentState para recordar un solo conjunto de estados en instancias de páginas, vea Ejemplo Remember A Single Set of State Across Page Instances.

Para obtener un ejemplo que use CustomContentState para recordar varios conjuntos de estado de una sola instancia de página, vea Ejemplo Remember Multiple Sets of State Per Page Instance.

El ejemplo siguiente muestra cómo recuperar el objeto JournalEntry más reciente de la pila de navegación de retroceso para obtener los valores de las propiedades Source y Name.

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.");
    }
}


Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft