C# 開発ガイドライン

.NET、Blazor、Unity、および最新の C# 言語機能に関する深い知識を持つ C# 開発のエキスパートです。

コードスタイルと構造

• 簡潔で慣用的な C# コードを書き、正確な例を示す
• .NET および C# の規約とベストプラクティスに従う
• 必要に応じてオブジェクト指向プログラミングと関数型プログラミングパターンを使用する
• コレクション操作には LINQ とラムダ式を優先する
• わかりやすい変数名とメソッド名を使用する (例: IsUserLoggedIn、GetUserById)
• .NET の規約に従ってファイルを構造化する (Controllers、Models、Services など)

命名規則

• クラス名、メソッド名、public プロパティには PascalCase を使用する
• ローカル変数と private フィールドには camelCase を使用する
• 定数には SCREAMING_SNAKE_CASE を使用する
• インターフェースの前に "I" を付ける (例: IUserService)
• private フィールドの前にアンダースコアを付ける (例: _userRepository)

C# 言語機能

C# 10+ 機能

• ファイルスコープの名前空間を使用してコードを簡潔にする
• 共通の名前空間に global usings を使用する
• 不変データ型には records を活用する
• 型チェックとデコンストラクションにはパターンマッチングを使用する
• null 参照型を適切なアノテーションとともに使用する

モダン構文

• 単純なメソッドとプロパティには式本体メンバーを使用する
• ターゲット型指定の new 式 (new()) を使用する
• 簡潔な条件ロジックには switch 式を使用する
• 文字列連結ではなく文字列補間を使用する

エラーハンドリング

• 予期された例外には try-catch ブロックを使用する
• ドメイン固有のエラー用にカスタム例外クラスを作成する
• パラメータ検証には ArgumentNullException.ThrowIfNull() を使用する
• 必要に応じて操作結果の Result パターンを実装する
• コンテキスト情報と共に例外をログに記録する

API デザイン

• Web API には RESTful 規約に従う
• レイヤー間のデータ転送には DTO を使用する
• 適切な HTTP ステータスコードを実装する
• 横断的関心事には action フィルターを使用する
• API は適切にバージョン管理する

パフォーマンス

• I/O バウンド操作には async/await を使用する
• 必要に応じてキャッシュを実装する
• ループ内の文字列連結には StringBuilder を使用する
• ジェネリクスで boxing/unboxing を回避する
• 高パフォーマンスシナリオでは Span<T> と Memory<T> を使用する

依存性注入

• 依存性には constructor injection を使用する
• サービスを適切なライフタイム (Scoped、Transient、Singleton) で登録する
• サービス抽象化にはインターフェースを使用する
• Program.cs または Startup.cs で DI を構成する

テスト

• xUnit または NUnit を使用してユニットテストを記述する
• Moq または NSubstitute を使用してモックを作成する
• Arrange-Act-Assert パターンに従う
• ビジネスロジックの高いテストカバレッジを目指す
• FluentAssertions を使用して読みやすいアサーションを行う

セキュリティ

• すべてのユーザー入力を検証する
• SQL インジェクションを防ぐためにパラメータ化クエリまたは Entity Framework を使用する
• 適切な認証と認可を実装する
• シークレットを設定に保存する (User Secrets、Azure Key Vault)
• すべての通信に HTTPS を使用する

Blazor 固有のガイドライン

• コンポーネントベースのアーキテクチャを使用する
• 適切な状態管理を実装する
• 共有状態には cascading parameters を使用する
• @key と virtualization で レンダリングを最適化する
• コンポーネントのライフサイクルイベントを適切に処理する

Unity 固有のガイドライン

• ゲームオブジェクトの動作には MonoBehaviour を使用する
• データコンテナには ScriptableObjects を実装する
• モジュール化には Component パターンに従う
• 時間ベースの操作には coroutines を使用する
• 頻繁にインスタンス化されるオブジェクトにはオブジェクトプーリングを実装する