プロジェクト情報・進め方
- .NET Framework 4.6.1
- Visual C#
- ASP.NET Web アプリケーション
- MVC 5
- 認証なし
- Homecontroller の Index アクション、ビューを修正していく
- SMTP サーバには Hotmail を利用した。Google アカウントは2段階認証や、アプリケーションパスワードなど、面倒事が多いため。
タグ: C#
エラー内容
- 【ASP.NET MVC5】ちょっとしたお試しをするときに土台となるアプリの作り方チュートリアル – oki2a24 の手順通りに進めていくと、途中でエラーとなってしまう。
- モデルクラス作成後に、コントローラーを自動生成しようとするとエラーとなる。
- プロパティとして、外部キーを書いた場合に発生
- エラーメッセージ
エラー
選択したコードジェネレータを実行中にエラーが発生しました : ‘Key already exists in table.’
解決方法のポイント
2016年8月18日11時12分追記: ソリューション全体をアップロードしました。
Identity をカスタマイズした独自の認証を持ったサンプルのアプリを作ってみました。Identity の拡張方法の習得を目標に、それ以外はシンプルに、あまりこだわらないようしております。
構築（勉強）の仕方
Visual Studio 2015 でプロジェクトを作成するときに認証処理を追加するように選択することができます。そうしますと、Identity を使用した認証ロジックと、ユーザーやロールを管理するデータベーステーブルが予め作られます。
このファイルやコードが大変参考になります。
そこで、ファイルの構成はプロジェクト生成時に自動作成される認証のあり方に近づけます。
コードの振る舞いや、内容の理解、実際に書くコードの内容は、参考ウェブページをお手本にいたします。
ポイント
[Index(IsUnique=true)]という Annotation 属性をプロパティに付けることでそのカラムは一意となる。- プロパティの型が String の場合、MaxLength も付ける必要がある。一意性をチェックするためには、カラムへの格納サイズが無限とも思われる String だとパフォーマンスが大きく低下するためと思われる。
モデルのコード
public class Sex
{
public int Id { get; set; }
[Required]
[Index(IsUnique=true)]
[MaxLength(10)]
public string Name { get; set; }
}
もし MaxLength 属性を付けなかった場合は、どうなったか？
にて DB データをエクスポートする機能を紹介いたしました。
今回は、対となるインポート機能を開発いたします♪
インポート機能のポイント
こちらのシステムでインポート機能を考えます。ポイントは次の 2 点です。
- CSV の 1 行に Parent とその Child を記入する。
- インポートできる子ども (Child) は 2 人まで。
Parent 1-n Child という関係を持っております。
ですのでシステム上は、Parent は必ず 1 つですけれども、それに紐づく Child はいくつあっても問題ありません。
ですけれども、インポート機能におきましては子どもの数の最大数を制限しませんと CSV ファイルの仕様を固めることが難しくなります。
したがいまして、今回は Child の数を最大 2 つとし、それ以上登録したい場合はウェブブラウザから追加する、という運用方法を想定いたしました。
CSV インポート開発の流れ
に沿ってサンプルプロジェクトを作成したところからスタートです。
ソリューションおよびプロジェクト名は Sample3 といたしました。
- コントローラー CsvController.cs をスキャフォールディング作成
- アップロードファイルに対応するモデル CsvFile.cs を作成
- アップロードするファイルの種類を検証する属性クラス UploadFileAttribute の作成
- ビュー Import.cshtml の作成
- インポート処理を司るサービスクラス CsvImportService の作成
- テスト CSV ファイル作成と、インポートの確認
コード例
の CreateCsv メソッドが次のように書けますわね♪
var sb = new StringBuilder(); sb.Append(GetCsvHeader()).Append(NEWLINE_CHARACTER); parentList.ForEach(p => sb.Append(CreateCsvLine(p)).Append(NEWLINE_CHARACTER)); return sb.ToString();
↓
var sb = new StringBuilder(); sb.AppendLine(GetCsvHeader()); parentList.ForEach(p => sb.AppendLine(CreateCsvLine(p))); return sb.ToString();
参考ページ
追記: インポート版も作りましたの♪
DB のデータを CSV に出力してウェブブラウザからダウンロードしたいですの！今回、それを実現するコードを残しておきますわ♪
CSV エクスポートの対象となるシステム
エクスポートされる CSV の仕様
- ヘッダ行を出力する。
- 1 行に Parent とその Child を 2 人分まで出力する。
- セルは常にダブルクォーテーション「”」で囲む。
- セルの区切り文字はカンマ「,」とする。
- 行末に区切り文字は付けない。
「1 行に Parent とその Child を 2 人分まで出力」いたしますので、子供が 0 人の場合は子どもの部分が空白となりますし、1 人の場合は 1 人分のみ埋まります。Child が 3 人の場合は、2 人分のみ CSV に書き込まれ、3 人目は記録されない点に注意ですの！
手順 1. CSV エクスポート用のコントローラー、ビューを作成
ポイント
- 標準で日本語対応しているのが嬉しい。
- DatePicker のフォーマットは yyyy-mm-dd とし、input date で使用するフォーマットに合わせること。これにより、DatePicker も input type date も両方使用できる。
- Chrome や Edge だと input type date も、DatePicker for Bootstrap も両方有効になり、好きな方で操作できる。input type date の yyyy/MM/dd フォーマットで表示された。
- Internet Explorer だと DatePicker が効いて yyyy-MM-dd フォーマットで表示される。
- input date は IE が対応していないため、後数年もすれば input date で DatePicker と同等のことができるようになるであろう。そうすると、DatePicker for Bootstrap は不要となると思う。
導入流れ、使い方まとめ
DatePicker 導入までの流れ
- パッケージマネージャーコンソールから DatePicker をインストール
- Datepicker 動作用の JavaScript を書く。
- BuldleConfig に DatePicker と 動作用の JavaScript を読みこませるよう記述
- _Layout.cshtml などのビューに、BuldleConfig で設定したパスを記述
DatePicker を使用するには、の例まとめ
- モデルのプロパティの DataType を Date に指定
- モデルのプロパティの DisplayFormat の DateFormatString を yyyy-MM-dd に、ApplyFormatInEditMode を true に設定する。
- ビューではタグの class に DatePicker 動作用のクラスを追加する。
DatePicker 導入の具体的な手順・コード
2016年8月16日追記: 本投稿のコードをアップいたしました。
追記: 【ASP.NET】【MVC5】お試しウェブアプリチュートリアルのエラーを解決 – oki2a24 で説明した通り、エラーを回避するために手順を一部変更しております。
サンプルアプリ概要
MVC 関係
- スキャフォールディングで各テーブルのコントローラー、ビューをぱっと作って済ませる。
- 認証なし
データベース関係
- データベース名: ApplicationDb
- テーブル
- Parents
- Children
- Sexes ← 男、女が入っているだけのマスタテーブル
- リレーション
- Parents 1-n Children
- Parents n-1 Sexes
- Children n-1 Sexes
- レコードから見るテーブルのリレーション表現は
- Parents には Children 関係のカラムは無い。
- Children は ParentsId カラムを持ち、親を指定する。
- Parents と Children は SexId を持ち、性別を指定する。
- Sexes には、他テーブル関係のカラムは無い。
それでは実際に作っていきましょう♪
ロギングのライブラリ、log4net を使う理由
ログのライブラリを使う理由は、次の2つです。
- ファイルのロック、排他制御をしてくれる
- 自動的にローテーションをしてくれる
log4net と NLog の2種類がメジャーなようです。
- log4net の方が歴史が長く、インターネット上の知見が多い。
- log4net の方が「枯れた技術」となっていそう。
- NLog の方が更新されている。
- NLog の方がパフォーマンスが優れている、というページがある。
今回は、歴史とノウハウが大きいという理由で log4net を採用いたしました。
では早速導入手順を残してまいります。2種類のやり方を解説いたします。
どちらもASP.NET MVC5 プロジェクトを作成し、アクティブになっている状態からスタートです♪