ASP.NET MVC(Frameworkの方) 簡単な開発手順まとめ

前提として、ChatGPT使いながらベースを書いたため誤りがあったら申し訳ございません。
開発にはVisual Studio 2017を利用しています。言語はC#です。
画像は無いです。
サンプルコードはおおよそ問題ないと思いますが、自動生成なので間違っていたら申し訳ございません。

プロジェクト作成から MVC サイト作成まで

1. プロジェクトの作成

Visual Studio を開く
- パソコンに Visual Studio がインストールされていることを確認します。
新規プロジェクトの作成
- 「ファイル」メニューから「新規作成」を選択します。
プロジェクトの選択
- 「プロジェクト...」をクリックして新しいプロジェクトを作成します。
テンプレートの選択
- 左側のメニューから「Visual C#」を選び、その下で「ASP.NET Web アプリケーション(.NET Framework)」を選択します。
ターゲットの.NET Framework の選択
- ターゲットの.NET Framework を選択します。
- 注意点としては自身の開発端末に使いたいバージョンの.Net Frameworkの開発パックがインストールされているか確認してください。
プロジェクトの設定
- 任意のプロジェクト名や保存先を設定し、「作成」ボタンをクリックします。
テンプレートの選択
- 「テンプレート」で「空」を選択します。
フォルダー及びコア参照の追加
- 「フォルダー及びコア参照の追加」を選択します。
MVC を追加する
- 画面に表示されるオプションから「MVC」を選択します。
OK を押す
- 設定が完了したら、「OK」ボタンをクリックしてプロジェクトの作成を確定します。

2. フォルダの作成

コンテンツ保存用フォルダの作成
- プロジェクトができたら、以下のコンテンツ保存用フォルダを作成します。
  - css
  - js
  - img　などなど
これに加えて、作成するサイトで必要なフォルダがあれば、追加してください。

3. コントローラーの作成

MVC におけるコントローラーについて

コントローラーはユーザーのアクションに応じて呼び出され、モデルからデータを取得し、適切なビューを呼び出す役割を果たします。ユーザーからのリクエストを受け取り、それに対する処理を実行するのが主な役割であり、ビジネスロジックの制御の中心です。

Controllers フォルダにコントローラーを作成する
- ソリューションエクスプローラで Controllers フォルダを右クリックします。
- 「追加」を選択します。
- 「コントローラー」を選択します。
- 「MVC 5 コントローラー - 空」を選択します。
コントローラーの設定
- コントローラー名に「〇〇 Controller」と入力します（〇〇には任意の名前が入ります）。
- 「追加」をクリックしてコントローラーを作成します。

各画面の処理を記述

コントローラーには各画面で「GET」および「POST」が行われた際の処理を記述します。

// GET: /〇〇/Index
public ActionResult Index()
{
    // 〇〇画面のGETリクエスト時の処理
    return View();
}

// POST: /〇〇/Index
[HttpPost]
public ActionResult Index(FormCollection form)
{
    // 〇〇画面のPOSTリクエスト時の処理
    // formオブジェクトを使用してフォームデータにアクセスする例
    return View();
}

4. モデルの作成

MVC におけるモデルについて

モデルはアプリケーションのデータやビジネスロジックを扱います。MVC では、モデルはアプリケーションのデータ構造やデータベースの操作を担当し、コントローラーとビューの間でデータのやり取りを行います。これにより、アプリケーションの各部分が役割分担され、柔軟で保守しやすいコードを実現します。

Models フォルダに新しいクラスを作成

Models フォルダにクラスを作成する
- ソリューションエクスプローラで Models フォルダを右クリックします。
- 「追加」を選択します。
- 「新しい項目」を選択します。
- 「Visual C#」 > 「コード」から「クラス」を選び、任意のクラス名を入力して「追加」ボタンをクリックします。

Modelsクラスを実装する

モデルのクラスを実装します。

using System;
using System.ComponentModel.DataAnnotations;
using System.Linq;

public class User
{
    [Key]
    public int UserId { get; set; }

    [Required(ErrorMessage = "ユーザー名は必須です。")]
    [StringLength(50, ErrorMessage = "ユーザー名は50文字以内で入力してください。")]
    public string UserName { get; set; }

    [Required(ErrorMessage = "メールアドレスは必須です。")]
    [EmailAddress(ErrorMessage = "正しいメールアドレスの形式で入力してください。")]
    public string Email { get; set; }

    [Required(ErrorMessage = "パスワードは必須です。")]
    [DataType(DataType.Password)]
    [StringLength(20, MinimumLength = 6, ErrorMessage = "パスワードは6〜20文字で入力してください。")]
    [CustomPasswordValidation(ErrorMessage = "パスワードには英大文字、英小文字、数字、特殊文字をそれぞれ1文字以上含めてください。")]
    public string Password { get; set; }
}

public class CustomPasswordValidationAttribute : ValidationAttribute
{
    public override bool IsValid(object value)
    {
        if (value == null || string.IsNullOrWhiteSpace(value.ToString()))
        {
            return false;
        }

        // パスワードに英大文字、英小文字、数字、特殊文字をそれぞれ1文字以上含むかどうかを検証
        var password = value.ToString();
        return HasUpperCase(password) && HasLowerCase(password) && password.Any(char.IsDigit) && password.Any(IsSpecialCharacter);
    }

    private bool HasUpperCase(string str)
    {
        return str.Any(char.IsUpper);
    }

    private bool HasLowerCase(string str)
    {
        return str.Any(char.IsLower);
    }

    private bool IsSpecialCharacter(char c)
    {
        // 例として、特殊文字が含まれていると判断する条件を設定
        var specialCharacters = new[] { '!', '@', '#', '$', '%', '^', '&', '*' };
        return specialCharacters.Contains(c);
    }
}

5. ビューの作成手順

MVC におけるビューについて

MVC（Model-View-Controller）では、ビューはユーザーに表示される情報を担当します。ビューは HTML や他のマークアップ言語を使用して、データをユーザーに適切な形で表示します。ビューは主にコントローラーから受け取ったモデルのデータを使ってページを構築します。また、ユーザーからの入力を受け付け、コントローラーに送信することもあります。

ビューは通常、特定のアクションや操作に関連付けられており、各ビューは対応するコントローラーアクションと結びついています。ビューの作成手順を理解することで、MVC アーキテクチャ内で柔軟かつ効果的にユーザーインターフェースを構築できます。

フォルダの作成
- Views フォルダ内に、各コントローラーごとに対応するフォルダを作成します。例えば、Views/Home、Views/Userなど。
ビューの追加
- 作成したフォルダを右クリックし、「追加」を選択します。
- 「ビュー」を選択します。
ビューの設定
- ビュー名を入力します。例えば、IndexやRegisterなど。
- 「テンプレート」で、モデルを使用する場合は「Empty」、モデルを使用しない場合は「Empty(モデルなし)」を選択します。
- 「レイアウトページの指定」では、必要に応じてレイアウトページをファイルを選択する形式で指定します。
- 「追加」ボタンをクリックしてビューを作成します。

ビューを実装する

ビューを実装します。

@model YourNamespace.Models.User

@{
    Layout = "~/Views/Shared/_Layout.cshtml";
}

<!DOCTYPE html>
<html>
<head>
    <title>User Registration</title>
</head>
<body>
    <h2>User Registration</h2>

    @using (Html.BeginForm("Register", "User", FormMethod.Post))
    {
        <div>
            @Html.LabelFor(model => model.UserName)
            @Html.TextBoxFor(model => model.UserName)
            @Html.ValidationMessageFor(model => model.UserName)
        </div>

        <div>
            @Html.LabelFor(model => model.Email)
            @Html.TextBoxFor(model => model.Email)
            @Html.ValidationMessageFor(model => model.Email)
        </div>

        <div>
            @Html.LabelFor(model => model.Password)
            @Html.PasswordFor(model => model.Password)
            @Html.ValidationMessageFor(model => model.Password)
        </div>

        <input type="submit" value="Register" />
    }
</body>
</html>

6. ルート設定手順

App_Start フォルダーの作成:
- プロジェクトのルートにApp_Startフォルダーが存在しない場合は、新しく作成します。
RouteConfig.cs の追加:
- App_Startフォルダー内で、右クリックして「新しい項目の追加」を選択します。
- 「Visual C#」 > 「コード」から「クラス」を選択し、名前をRouteConfig.csとして追加します。

RouteConfig.cs の編集:

RouteConfig.csを開いて、RegisterRoutesメソッドを作成し、必要なルート設定を追加します。以下はサンプルです。

// App_Start/RouteConfig.cs

using System.Web.Mvc;
using System.Web.Routing;

public class RouteConfig
{
    public static void RegisterRoutes(RouteCollection routes)
    {
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

        routes.MapRoute(
            name: "Default",
            url: "{controller}/{action}/{id}",
            defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
        );
    }
}

グローバルアプリケーションクラスの設定:

Global.asax や Global.asax.cs など、グローバルなアプリケーションクラスで、RouteConfig を有効にします。以下はサンプルです。

// Global.asax.cs

using System.Web;
using System.Web.Mvc;
using System.Web.Optimization;
using System.Web.Routing;

public class MvcApplication : HttpApplication
{
    protected void Application_Start()
    {
        AreaRegistration.RegisterAllAreas();

        // ここでRouteConfigを有効にする
        RouteConfig.RegisterRoutes(RouteTable.Routes);
    }
}

7. エラーハンドリングフィルター設定

フィルターについて

FilterConfig.cs は ASP.NET MVC プロジェクトにおいて、グローバルなフィルターを設定するためのクラスです。このクラスは通常、アプリケーションの開始時に呼び出される FilterConfig.RegisterGlobalFilters メソッドを使用して、グローバルなフィルターを登録します。

フィルターは、MVC アプリケーションで実行されるアクションメソッドや要求、またはその他のイベントに影響を与えるカスタムロジックを提供します。例えば、エラーハンドリング、認証、出力キャッシュなどがフィルターを使用して実装されることがあります。

App_Start フォルダーの作成:
- プロジェクトのルートにApp_Startフォルダーが存在しない場合は、新しく作成します。
FilterConfig.cs の追加:
- App_Startフォルダー内で、右クリックして「新しい項目の追加」を選択します。
- 「Visual C#」 > 「コード」から「クラス」を選択し、名前をFilterConfig.csとして追加します。
RouteConfig.cs の編集:
- RegisterGlobalFiltersメソッド内に以下の行を追加して、HandleErrorAttributeを登録します。
- HandleErrorAttribute はエラーが発生した場合、デフォルトで~/Views/Shared/Error.cshtml ビューを表示します。もしカスタムのエラーページを使用したい場合は、Error.cshtml を作成し、ビューを変更してください。
```
public class FilterConfig
{
    public static void RegisterGlobalFilters(GlobalFilterCollection filters)
    {
        filters.Add(new HandleErrorAttribute());
        // 他のフィルターを追加する場合はここに追加
    }
}
```

global.asax.cs への追記:

global.asax.csファイルを開き、Application_Start メソッド内に以下の行を追加します。

protected void Application_Start()
{
    // 他の初期化処理...

    AreaRegistration.RegisterAllAreas();
    FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); // ここを追記
    RouteConfig.RegisterRoutes(RouteTable.Routes);
}

実際はCSSやJSを書いたりまだまだやることはありますが、おおよそこの流れで開発すれば一通りの物が出来上がると思います。