Prism Library 5.0 for WPFを使用したビュー切り替えナビゲーションのクイックスタート

1. Visual Studioでは、ソリューション・ファイルQuickstarts\View-Switching Navigation_Desktop\ ViewSwitchingNavigation.slnを開けます。
2. Buildメニュー内で、Rebuild Solutionをクリックします。
3. QuickStartを実行するために、F5を押してください。

The Journal

履歴は、移動するViewの履歴を保持するスタックです。 それは、訪問したページの前方、現在と後方への履歴を格納します。 RecordNavigationメソッドは、スタックで、現在のViewを登録するために使用されます。 あなたは、履歴Viewの内部で移動する場合、履歴は、Viewをスタックに追加することを避けます。

備考

あなたが、ナビゲーションを実装する前に、それは、あなたが、統一リソース識別子 (URI)構造をアプリケーションに定義することが重要です。

The Calendar Module (Cross-Navigation to Other Modules)

Calendarモジュールは、もう一つの範囲/モジュールに、またいで移動する方法を示します。 次のコード例は、CalendarモジュールのInitializeメソッドを表示します。

C#

public void Initialize()
{
    this.regionManager.RegisterViewWithRegion(RegionNames.MainNavigationRegion, typeof(CalendarNavigationItemView));
}

Initializeメソッドは、CalendarNavigationItemViewビューを登録します。 それは、カレンダー機能を表示するために、使用するボタンです。 CalendarViewビューは、ここで、登録されることができました。 しかし、私たちは、（ナビゲーション間で、ジャストインタイムの作成を通して）領域が利用できるViewを作成するために、異なる仕組みを使用しています。

このボタンのイベントハンドラは、次のコードの例に示すように、 領域の名前を渡して、equestNavigateメソッドを呼び出す領域マネージャーを使用し、そして、URIに移動します。

C#

private void Button_Click(object sender, RoutedEventArgs e)
{            
    this.regionManager.RequestNavigate(RegionNames.MainContentRegion, calendarViewUri);
}

移動が、完了すると、－すなわち、カレンダー・ビューは、中心となる領域で読み込まれるとき、 そして、Navigatedイベントが起動します。－ボタンが、ユーザーに知らせるために確認されます。 中心となる領域に表示されるViewは、カレンダーです。 これは、次のコード例で、示されています。 QuickStartのあらゆるモジュールは、これらのタスクを実行するために、同じようなコードを持っています。

C#

public void MainContentRegion_Navigated(object sender, RegionNavigationEventArgs e)
{
    this.UpdateNavigationButtonState(e.Uri);
}

private void UpdateNavigationButtonState(Uri uri)
{
    this.NavigateToCalendarRadioButton.IsChecked = (uri == calendarViewUri);
}

このQuickStartが、MVVMパターンを実装するため、ロジックは、View Modelクラスに配置されます（ナビゲーション・アイテム・ビューを除外します）。 あなたは、URIsを構築することができます。それは、ViewやView Modelに、コンテキストを渡すクエリ文字列を使用します。 例えば、CalendarビューのView Modelクラスで、ユーザーが、会議をクリックすると、クエリ文字列が、ディスプレイに電子メール・メッセージを識別するために、使用されます。 あなたは、次のコード例で、移動するための、URIの構築と要求を見ることができます。

C#

private void OpenMeetingEmail(Meeting meeting)
{
    var parameters = new NavigationParameters();
    parameters.Add(EmailIdName, meeting.EmailId.ToString(GuidNumericFormatSpecifier));

    this.regionManager.RequestNavigate(RegionNames.MainContentRegion, new Uri(EmailViewName + parameters, Urikind.Relative));
}

前述のコードで、PrismのNavigationParametersクラスを使用して、特定のメールのIDが、指定されます。 このクラスは、問合せに追加されている、問合せパラメータを作成します。名前とパラメータの値を取得することによって、 このクラスのToStringメソッドは、すべての指定されたパラメータで、クエリ文字列を作成するために、上書きされます。 この例は、Query Stringを使用して、文字列のパラメータを渡すために、どのように、NavigationParametersクラスを使用するかを紹介します。 しかし、また、それは、RequestNavigateメソッドのオーバーロードを使用して、オブジェクト・パラメータを渡すために、使用することができます。 最後に、問合せは、Viewの名前に添付されます。結果は、次の図に示されいるものと類似しているでしょう。

複雑なURI構造

A complex URI structure

最後に、RequestNavigateメソッドを使用して、領域は、作成されたUriに移動するでしょう。

Contactsモジュール（入れ子にされたViewへの移動）

[Export]
[ViewSortHint("03")]
public partial class ContactsDetailNavigationItemView : UserControl, IPartImportsSatisfiedNotification
{
    private const string mainContentRegionName = "MainContentRegion";

    private static Uri contactsDetailsViewUri = new Uri("ContactsView?Show=Details", UriKind.Relative);

    ...


    private void NavigateToContactDetailsRadioButton_Click(object sender, RoutedEventArgs e)
    {
        this.regionManager.RequestNavigate(mainContentRegionName, contactsDetailsViewUri);
    }
}

void INavigationAware.OnNavigatedTo(NavigationContext navigationContext)
{
    // Navigating an inner region based on context
    // コンテキストに基づいて、内部の領域を移動します。
    // The ContactsView will navigate an inner region based on the
    // value of the 'Show' query parameter.  If the value is 'Avatars'
    // we will navigate to the avatar view otherwise we'll use the details view.

// ContactsViewは、『Show』問合せパラメータの値に基づいて、内部の領域を移動します。
// 値が『Avatars』である場合、私たちは、それ以外の場合に、アバターViewに移動します。
// 私たちは、詳細ビューを使用します。

    NavigationParameters parameters = navigationContext.Parameters;
    if (parameters != null && string.Equals(parameters[ShowParameterName].ToString(), AvatarsValue))
    {
        regionManager.RequestNavigate(ContactsRegionNames.ContactDetailsRegion, new Uri(ContactAvatarViewName, UriKind.Relative));
    }
    else
    {
        regionManager.RequestNavigate(ContactsRegionNames.ContactDetailsRegion, new Uri(ContactDetailViewName, UriKind.Relative));
    }
}

The Email Module

E-mail機能は、Viewにナビゲーションを実演します。それは、ユーザー活動に基づいて、追加のナビゲーションを処理します。 このモジュールのView Modelは、ナビゲーションに関与するために、INavigationAwareインターフェイスを実装します。

Emailモジュールでは、ほとんどの操作は、View Modelで実行されます。このモジュールは、3つのViewで構成されます。： メール・リスト（InboxView View）、開いたメール（EmailView View）、そして、 メールの作成（ComposeEmailView View）次のコード例は、メソッドを示します。 それは、New、Reply、Openボタン動作を操作します。それらが、まさしく今、クエリ文字列を作成することに注意します。 そして、その次に、中心となる領域内の、対応するViewに移動します。

C#

private void ComposeMessage(object ignored)
{
    this.regionManager.RequestNavigate(RegionNames.MainContentRegion, ComposeEmailViewUri);
}

private void ReplyMessage(object ignored)
{
    var currentEmail = this.Messages.CurrentItem as EmailDocument;
    if (currentEmail != null)
    {
        var parameters = new NavigationParameters();
        parameters.Add(ReplyToKey, currentEmail.Id.ToString("N"));         this.regionManager.RequestNavigate(RegionNames.MainContentRegion, ComposeEmailViewKey + parameters);
    }
}

private bool CanReplyMessage(object ignored)
{
    return this.Messages.CurrentItem != null;
}

private void OpenMessage(EmailDocument document)
{
    NavigationParameters parameters = new NavigationParameters();
    parameters.Add(EmailIdKey, document.Id.ToString("N"));     this.regionManager.RequestNavigate(RegionNames.MainContentRegion, new Uri(EmailViewKey + parameters, UriKind.Relative));

ComposeEmailViewModelは、ViewやView Modelが、移動されることを扱うかどうかに関係なく、 決定するために使用されるIConfirmNavigationRequestインターフェイスを実装しています。 このインターフェイスは、ConfirmNavigationRequestメソッドを持っています。 それは、ナビゲーション要求の取消しを提供します。構成される電子メール画面では、 ユーザーは、メッセージを記述し始めますが、送信しないかもしれません。 その結果、ユーザーは、彼/彼女が、離れて移動する前に、メッセージを破棄することを望むか、確認を促す必要があります。 次のコードは、ComposeEmailViewModelクラスに、ConfirmNavigationRequestメソッドの実装を示します。 View Modelは、ユーザーを促すために、InteractionRequestを使用します。 そして、ユーザーが確認する場合、continuationCallbackが、パラメータとして渡されるとき、 彼/彼女が、離れて移動することを望むために、移動を継続します。

備考

あなたは、continuationCallback動作を呼び出す必要があります。 あるいは、あなたは、この現在のナビゲーション要求を停止させるでしょう。そして、この要求の更なる処理は行われません。

ComposeEmailViewModelクラスでは、ユーザーが、新しい電子メール・メッセージを作成する、 あるいは、既存のものに返信する場合、OnNavigatedToメソッドは、決定するために使用されます。 ナビゲーション・コンテキストは、Parametersプロパティを通して、コンテクストの情報を提供します。 それは、RequestNavigateメソッド、あるいは、ナビゲーションURIを通じて、渡されるパラメータから、構築されるstring/object辞書です。 次のコードの例では、ReplyToパラメータが、値を含む場合、電子メール・サービスからの関連情報は、応答値を埋め込むために取得されます。 そうでない場合、空の電子メールが表示されます。

C#

void INavigationAware.OnNavigatedTo(NavigationContext navigationContext)
{
    var emailDocument = new EmailDocument();
    var parameters = navigationContext.Parameters;
    var replyTo = parameters[ReplyToParameterKey];
    Guid replyToId;
    if (replyTo != null && Guid.TryParse(replyTo, out replyToId))
    {
        var replyToEmail = this.emailService.GetEmailDocument(replyToId);
        if (replyToEmail != null)
        {
            emailDocument.To = replyToEmail.From;
            emailDocument.Subject = Resources.ResponseMessagePrefix + replyToEmail.Subject;

            emailDocument.Text =
                Environment.NewLine +
                replyToEmail.Text
                    .Split(Environment.NewLine.ToCharArray())
                    .Select(l => l.Length > 0 ? Resources.ResponseLinePrefix + l : l)
                    .Aggregate((l1, l2) => l1 + Environment.NewLine + l2);
        }
    }
    else
    {
        var to = parameters[ToParameterKey];
        if (to != null)
        {
            emailDocument.To = to;
        }
    }

    this.EmailDocument = emailDocument;
    this.navigationJournal = navigationContext.NavigationService.Journal;
}

ナビゲーションの履歴は、前述のコードの終わりに、インスタンスを生成することに注意します。 履歴は、先程のViewに移動するために使用されます。 履歴は、移動する履歴の後方に移動することのために、GoBackメソッドを提供します。 これは、ユーザーが、作成した電子メール・メッセージを送信、あるいは、キャンセルしたあと、使用されます。 あなたは、次のコード例の、このメソッドの使用状況を確認することができます。

C#

private void CancelEmail()
{
    if (this.navigationJournal != null)
    {
        this.navigationJournal.GoBack();
    }
}

Unit and Acceptance Tests

ビューの切り替えナビゲーションのQuickStartには、ソリューション内のユニット・テストが含まれています。 ソース・コードのそれぞれの単位が、予想通りに動作する場合、ユニット・テストは、検証します。

ビュー切り替えナビゲーションのクイックスタートユニット・テストを実行するために、

ビュー切り替えナビゲーションのクイックスタートの受入検査を実行します。

More Information

Prismのナビゲーションの他の測面について学ぶために、次のトピックを参照してください。：

• ナビゲーション
• 状態に基づいたナビゲーションのクイックスタート

Prismに含まれる、他のコードサンプルについて学ぶためには、次のトピックを参照してください。：

• 株トレーダーの参考になる実装
• モジュール方式のクイックスタート
• インタラクティブ性のクイックスタート
• MVVMクイックスタート
• 命令のクイックスタート
• UI構成のクイックスタート
• 状態に基づいたナビゲーションのクイックスタート
• イベント集約のクイックスタート