【ASP.NET(C#)５】データ一覧画面と作成画面を一緒にしたい。複数のmodel（モデル）参照方法

今回も前回記事や４の記事でCRUDを作成した所からの解説です。CRUDまでを参照したい方は以下の記事を参照してください。４は通常実装向け／５はスキャフォールディング向けです。

2024.03.11

2024.03.11

こちらもオススメ！【ASP.NET(C#)１１】ソース公開！React.js または Razor+SQLServer または PostgreSQLを使った掲示板SPAのBBS_Webアプリ（.NET 6、8）

2024.08.26

1 作成画面と一覧（index）画面を一緒にするには？
2 修正後
- 2.1 注意点：ViewModelのArticleEntityのフィールド名はCreateでの ArticleEntity の引数名と同じにしよう
3 今回の参考記事
4 まとめ

作成画面と一覧（index）画面を一緒にするには？

WordPressの管理画面もそうですが最初の画面には通常ダッシュボード／一覧と呼ばれるインデックスが表示されているだけで作成画面は一緒にしないのが通常だと思います。

ただし、簡易掲示板や昔は主流だったチャットのようなやりとりが味わえた伝言板のようなWebアプリケーションを作りたくなった時とかは、一覧画面と一緒に書き込みできるフォームがあった方が楽ではありませんか？

今回はそんなケースにお答えした記事になります。

基本はCreate.cshtmlのフォームの部分をIndex.cshtmlにコピーすればよいですが・・以下の二つのエラーが出てしまいます。

RZ2001 The ‘model’ directive may only occur once per document.

このエラーは検索してもあまり検索してもひっかからないのですが翻訳すると以下のような意味です。

モデルディレクティブは、ドキュメントごとに1回だけ発生する可能性があります

これはGoogle翻訳した結果ですが、意訳するとモデルの定義は一つのソース一つだけということだと思います。

今回はCreateに使う単独のModels.ArticleEntity と複数が前提のIEnumerable< Models.ArticleEntity＞どちらも使いたい。

この件に限らず、もっと複雑なWeb APIになると一つの画面で複数のmodelを参照したい事もあるでしょう。その時はどうすればよいのか？

今のままでは作成側のArticleEntityは参照できないので配置することができません。

ViewModelを使う

この時はViewModelというModelを新たに定義して使います。要はModelを一個作ってその中に個々のモデルを入れちゃうという感じですね。

ちなみにWPFの回でMVVMパターンで言うViewModelはViewとModelをつないでいるもの。みたいな説明をしました。WPFの場合は基本このMVVMパターンに乗っ取って制作するお作法のようなものですが、今回のASP.NETで用いているViewModelはModelを複数使いたい時だけ使用するものでMVVMパターンを使ったお作法ではありませんのでそこは混同しないように注意しましょう。とはいえ、Viewで使うものでModelの定義を複数つなぐために使用するものなので役割的には一緒と思ってもらって良いと思います。

WPFでのMVVMパターンについては下記記事を参照。

関連記事【WPF(XAML)C#１】MVVMパターンの基礎とGridの使い方

2022.03.03

.NET 6 バージョンでMVCを作成すると最初からErrorViewModel.csというものができていますがこれも同じ役目なのかと思います。

Modelsフォルダと分けて作った方がわかりやすい

今回はViewModelsフォルダを作成して、その下にArticleViewModel.csを作成しました。Viewで使っていた型に合わせて以下のように修正します。

using WebBBS.Models;

namespace WebBBS_2.ViewModels
{
    public class ArticleViewModel
    {
        public ArticleEntity articleEntity { get; set; }

        public IEnumerable<ArticleEntity> articleEntities { get; set; }
    }
}

次にArticleEntitesControllerのIndex部分にはViewModelを通知するように変更しなければいけません。

こちらはスキャフォールディングされた修正前のソースですがこれを以下のように修正します。

// GET: ArticleEntities
public async Task<IActionResult> Index()
{
    ArticleViewModel articleViewModel = new ArticleViewModel
    {
        articleEntity = new ArticleEntity(),
        articleEntities = await _context.ArticleEntity.ToListAsync()
    };

    return View(articleViewModel);
}

これで二つのモデルを統合したViewModelを渡せましたのでViewのindex.cshtmlを以下のように修正します。

@using WebBBS_2.ViewModels
@model ArticleViewModel

@{
    ViewData["Title"] = "Index";
    Layout = "~/Views/Shared/_Layout.cshtml";
}

<h1>Index</h1>

<div class="row">
    <div class="col-md-4">
        <form asp-action="Create">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="articleEntity.Title" class="control-label"></label>
                <input asp-for="articleEntity.Title" class="form-control" />
                <span asp-validation-for="articleEntity.Title" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="articleEntity.Name" class="control-label"></label>
                <input asp-for="articleEntity.Name" class="form-control" />
                <span asp-validation-for="articleEntity.Name" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="articleEntity.Description" class="control-label"></label>
                <input asp-for="articleEntity.Description" class="form-control" />
                <span asp-validation-for="articleEntity.Description" class="text-danger"></span>
            </div>
            <div class="form-group">
                <input type="submit" value="Create" class="btn btn-primary" />
            </div>
        </form>
    </div>
</div>


<table class="table">
    <thead>
        <tr>
            <th>
                @Html.DisplayNameFor(model => model.articleEntity.Title)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.articleEntity.Name)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.articleEntity.Description)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.articleEntity.Created)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.articleEntity.Updated)
            </th>
            <th></th>
        </tr>
    </thead>
    <tbody>
@foreach (var item in Model.articleEntities) {
        <tr>
            <td>
                @Html.DisplayFor(modelItem => item.Title)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.Name)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.Description)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.Created)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.Updated)
            </td>
            <td>
                <a asp-action="Edit" asp-route-id="@item.Id">Edit</a> |
                <a asp-action="Details" asp-route-id="@item.Id">Details</a> |
                <a asp-action="Delete" asp-route-id="@item.Id">Delete</a>
            </td>
        </tr>
}
    </tbody>
</table>