josiadmin/awesome-copilot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
awesome-copilot/instructions/dotnet-framework.instructions_ja.md

6.9 KiB
Raw Blame History

description applyTo
.NETFrameworkプロジェクトでの作業ガイダンス。プロジェクト構造、C#言語バージョン、NuGet管理、ベストプラクティスを含む。 **/*.csproj, **/*.cs

.NET Framework 開発

ビルドとコンパイルの要件

  • ソリューションやプロジェクトのビルドにはdotnet buildではなく、常にmsbuild /t:rebuildを使用する

プロジェクトファイル管理

非SDKスタイルプロジェクト構造

.NET Frameworkプロジェクトは、最新のSDKスタイルプロジェクトとは大幅に異なるレガシープロジェクト形式を使用します：

  • 明示的ファイル包含: すべての新しいソースファイルは<Compile>要素を使用してプロジェクトファイル（.csproj）に明示的に追加する必要がある

    • .NET FrameworkプロジェクトはSDKスタイルプロジェクトのようにディレクトリ内のファイルを自動的に含まない
    • 例: <Compile Include="Path\To\NewFile.cs" />

  • 暗黙的インポートなし: SDKスタイルプロジェクトとは異なり、.NET Frameworkプロジェクトは共通の名前空間やアセンブリを自動的にインポートしない

  • ビルド構成: Debug/Release構成用の明示的な<PropertyGroup>セクションを含む

  • 出力パス: 明示的な<OutputPath>と<IntermediateOutputPath>の定義

  • ターゲットフレームワーク: <TargetFramework>ではなく<TargetFrameworkVersion>を使用

    • 例: <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>

NuGet パッケージ管理

  • .NET FrameworkプロジェクトでのNuGetパッケージのインストールと更新は、複数のファイルに対する協調的な変更を必要とする複雑な作業です。そのため、このプロジェクトではNuGetパッケージのインストールや更新を試行しないでください。
  • 代わりに、NuGet参照の変更が必要な場合は、Visual Studio NuGetパッケージマネージャーまたはVisual Studioパッケージマネージャーコンソールを使用してNuGetパッケージをインストールまたは更新するようユーザーに依頼してください。
  • NuGetパッケージを推奨する際は、.NET Frameworkまたは.NET Standard 2.0と互換性があることを確認してください（.NET Coreや.NET 5+のみではなく）。

C# 言語バージョンは 7.3

  • このプロジェクトはC# 7.3機能のみに制限されています。以下の使用を避けてください：

C# 8.0+機能（サポートされていない）:

  • Using宣言（using var stream = ...）
  • Await using文（await using var resource = ...）
  • Switch式（variable switch { ... }）
  • Null合体代入（??=）
  • 範囲とインデックス演算子（array[1..^1]、array[^1]）
  • デフォルトインターフェースメソッド
  • 構造体の読み取り専用メンバー
  • 静的ローカル関数
  • Null許容参照型（string?、#nullable enable）

C# 9.0+機能（サポートされていない）:

  • レコード（public record Person(string Name)）
  • init専用プロパティ（{ get; init; }）
  • トップレベルプログラム（Mainメソッドなしのプログラム）
  • パターンマッチング拡張
  • ターゲット型指定new式（List<string> list = new()）

C# 10+機能（サポートされていない）:

  • グローバルusing文
  • ファイルスコープ名前空間
  • レコード構造体
  • 必須メンバー

代わりに使用（C# 7.3互換）:

  • 中括弧付きの従来のusing文
  • switch式ではなくswitch文
  • null合体代入ではなく明示的なnullチェック
  • 手動インデックスによる配列スライス
  • デフォルトインターフェースメソッドではなく抽象クラスまたはインターフェース

環境考慮事項（Windows環境）

  • バックスラッシュ付きのWindowsスタイルパスを使用（例：C:\path\to\file.cs）
  • ターミナル操作を提案する際はWindows適切なコマンドを使用
  • ファイルシステム操作を扱う際はWindows固有の動作を考慮

一般的な.NET Frameworkの落とし穴とベストプラクティス

Async/Awaitパターン

  • ConfigureAwait(false): デッドロックを避けるため、ライブラリコードでは常にConfigureAwait(false)を使用： 
    var result = await SomeAsyncMethod().ConfigureAwait(false);
  • sync-over-asyncを避ける: .Resultや.Wait()、.GetAwaiter().GetResult()を使用しない。これらのsync-over-asyncパターンはデッドロックと性能低下を引き起こす可能性があります。非同期呼び出しには常にawaitを使用してください。

DateTime処理

  • タイムスタンプにはDateTimeOffsetを使用: 絶対時点にはDateTimeよりDateTimeOffsetを優先
  • DateTimeKindを指定: DateTimeを使用する際は、常にDateTimeKind.UtcまたはDateTimeKind.Localを指定
  • カルチャ対応フォーマット: シリアル化/解析にはCultureInfo.InvariantCultureを使用

文字列操作

  • 連結にはStringBuilder: 複数の文字列連結にはStringBuilderを使用
  • StringComparison: 文字列操作では常にStringComparisonを指定： 
    string.Equals(other, StringComparison.OrdinalIgnoreCase)

メモリ管理

  • Disposeパターン: アンマネージリソースに対してIDisposableを適切に実装
  • Using文: IDisposableオブジェクトは常にusing文でラップ
  • 大オブジェクトヒープを避ける: LOH割り当てを避けるためオブジェクトを85KB未満に保つ

構成

  • ConfigurationManagerを使用: ConfigurationManager.AppSettingsを通じてアプリ設定にアクセス
  • 接続文字列: <appSettings>ではなく<connectionStrings>セクションに格納
  • 変換: 環境固有設定にはweb.config/app.config変換を使用

例外処理

  • 具体的な例外: 汎用的なExceptionではなく具体的な例外型をキャッチ
  • 例外を隠さない: 例外を適切にログ記録または再スロー
  • 破棄可能リソースにはusingを使用: 例外発生時でも適切なクリーンアップを保証

パフォーマンス考慮事項

  • ボクシングを避ける: 値型とジェネリクスでのボクシング/アンボクシングに注意
  • 文字列インターン: 頻繁に使用される文字列に対してstring.Intern()を慎重に使用
  • 遅延初期化: 高コストなオブジェクト作成にはLazy<T>を使用
  • ホットパスでのリフレクションを避ける: 可能な場合はMethodInfo、PropertyInfoオブジェクトをキャッシュ