CustomContentState Класс

Определение

public ref class CustomContentState abstract

[System.Serializable]
public abstract class CustomContentState

public abstract class CustomContentState

[<System.Serializable>]
type CustomContentState = class

type CustomContentState = class

Public MustInherit Class CustomContentState

Наследование

Object

CustomContentState

Атрибуты

SerializableAttribute

Примеры

Ниже приведен пример CustomContentState реализации, которая переопределяет JournalEntryName.

using System;
using System.Windows.Controls;
using System.Windows.Navigation;
[Serializable]
public class MyCustomContentState : CustomContentState
{
    string dateCreated;
    TextBlock dateTextBlock;

    public MyCustomContentState(string dateCreated, TextBlock dateTextBlock)
    {
        this.dateCreated = dateCreated;
        this.dateTextBlock = dateTextBlock;
    }

    public override string JournalEntryName
    {
        get
        {
            return "Journal Entry " + this.dateCreated;
        }
    }

    public override void Replay(NavigationService navigationService, NavigationMode mode)
    {
        this.dateTextBlock.Text = this.dateCreated;
    }
}

Imports System.Windows.Controls
Imports System.Windows.Navigation
<Serializable>
Public Class MyCustomContentState
    Inherits CustomContentState
    Private dateCreated As String
    Private dateTextBlock As TextBlock

    Public Sub New(ByVal dateCreated As String, ByVal dateTextBlock As TextBlock)
        Me.dateCreated = dateCreated
        Me.dateTextBlock = dateTextBlock
    End Sub

    Public Overrides ReadOnly Property JournalEntryName() As String
        Get
            Return "Journal Entry " & Me.dateCreated
        End Get
    End Property

    Public Overrides Sub Replay(ByVal navigationService As NavigationService, ByVal mode As NavigationMode)
        Me.dateTextBlock.Text = Me.dateCreated
    End Sub
End Class

Комментарии

По умолчанию NavigationService не сохраняет экземпляр объекта содержимого в журнале навигации. Вместо этого NavigationService создает новый экземпляр объекта содержимого при каждом переходе к нему с помощью журнала навигации. Такое поведение позволяет избежать чрезмерного использования памяти при переходе к большому количеству и большим фрагментам содержимого. Следовательно, состояние содержимого не запоминается при переходе к другой. Однако WPF предоставляет возможность связать часть пользовательского состояния с записью журнала навигации для части содержимого.

Пользовательское состояние, связанное с записью журнала навигации, должно быть классом, производным от CustomContentState. Для связывания CustomContentState объекта с записью журнала навигации используется один из следующих способов:

• Вызов AddBackEntry:

  • NavigationService.AddBackEntry

  • NavigationWindow.AddBackEntry

  • Frame.AddBackEntry.

• Настройка NavigatingCancelEventArgs.Content при возникновении одного из следующих событий:

  • NavigationService.Navigating

  • NavigationWindow.Navigating

  • Frame.Navigating

  • NavigationWindow.Navigating

• Путем реализации IProvideCustomContentState в классе, который хочет связать пользовательское состояние с ним.

При переходе к записи журнала навигации WPF проверяет, связан ли с ней пользовательский CustomContentState объект. Если это так, он вызывает Replay , чтобы разрешить пользовательскому CustomContentState объекту применять состояние, которое он запомнил из предыдущей навигации.

Пользовательский CustomContentState класс может переопределить JournalEntryName , чтобы изменить имя, отображаемое для записи журнала навигации CustomContentState , с которой связан объект. Возвращаемое JournalEntryName значение отображается из пользовательского интерфейса навигации различных навигаторов (браузера, NavigationWindowили Frame).

Класс, производный от CustomContentState , должен быть сериализуемым, что означает, что он должен быть по крайней мере дополнен SerializableAttributeс помощью и при необходимости реализовывать ISerializable.

Конструкторы

Свойства

Методы

Применяется к

См. также раздел

• NavigationService
• JournalEntry