オプション、テキスト エディター、C#、詳細設定

[詳細オプション] ページを使用して、エディターの書式設定、コードリファクタリング、および C# の XML ドキュメント コメントの設定を変更します。 このオプション ページにアクセスするには、[ ツール>オプション] を選択し、[ テキスト エディター>C#>Advanced] を選択します。

分析

ディレクティブの使用

• using の並べ替え時に最初に 'System' ディレクティブを配置する

  選択すると、右クリック メニューの [Remove and Sort Usings]\(使用の削除と並べ替 え\) コマンドによって、 using ディレクティブが並べ替えられ、'System' 名前空間が一覧の一番上に配置されます。

  並べ替え前:

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  並べ替え後:

  using System;
  using System.Collections.Generic;
  using System.Linq;
  using AutoMapper;
  using FluentValidation;
  using Newtonsoft.Json;
  

• using ディレクティブ グループを分離する

  このオプションを選択すると、右クリック メニューの [Remove and Sort Usings]\(使用の削除と並べ替え \) コマンドは、同じルート名前空間を持つディレクティブのグループ間に空の行を挿入することで、 using ディレクティブを区切ります。

  並べ替え前:

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  並べ替え後:

  using AutoMapper;
  
  using FluentValidation;
  
  using Newtonsoft.Json;
  
  using System;
  using System.Collections.Generic;
  using System.Linq;
  

• .NET Framework アセンブリの型の使用を提案する

• NuGet パッケージの型の使用を提案する

  これらのオプションを選択すると、 クイック アクション を使用して NuGet パッケージをインストールし、参照されていない型の using ディレクティブを追加できます。

  

• 貼り付け時に不足している using ディレクティブを追加する

  このオプションを選択すると、 using ディレクティブは、ファイルに型を貼り付けると自動的にコードに追加されます。

強調 表示

• カーソルの下にある記号への参照を強調表示する

  カーソルがシンボル内に配置されている場合、またはシンボルをクリックすると、コード ファイル内のシンボルのすべてのインスタンスが強調表示されます。

アウトライン

• ファイルを開いたときにアウトライン モードに入る

  オンにすると、コード ファイルのアウトラインが自動的に表示され、折りたたみ可能なコード ブロックが作成されます。 ファイルが初めて開かれると、#regions ブロックと非アクティブなコード ブロックが折りたたまれます。

• プロシージャ行の区切り記号を表示する

  テキスト エディターは、プロシージャのビジュアル スコープを示します。 次の表に示す場所にあるプロジェクトの .cs ソース ファイルに線が描画されます。

  ソース ファイル内の場所.cs	線の位置の例
  ブロック宣言コンストラクトのクローズ後	- クラス、構造体、モジュール、インターフェイス、または列挙型の末尾 - プロパティ、関数、またはサブの後 - プロパティ内の get 句と set 句の間にありません
  一連の単一行コンストラクトの後	- import ステートメントの後、クラス ファイル内の型定義の前 - クラスで宣言された変数の後、プロシージャの前
  1 行宣言の後 (非ブロック レベル宣言)	- import ステートメントの後、ステートメント、変数宣言、イベント宣言、デリゲート宣言、DLL 宣言ステートメントを継承します

ブロック構造ガイド

コード内の中かっこ ({}) の間に点線の垂直線を表示するには、これらのチェック ボックスをオンにします。 その後、宣言レベルとコード レベルのコンストラクトの個々のコード ブロックを簡単に確認できます。

コメント

• /// の XML ドキュメント コメントを生成する

  選択した場合、 /// コメントの概要を入力した後、XML ドキュメント コメントの XML 要素を挿入します。 XML ドキュメントの詳細については、「 XML ドキュメント コメント (C# プログラミング ガイド)」を参照してください。

抽出メソッド

• カスタム構造体に ref または out を配置しない

  メソッド呼び出しに式を抽出するときに既存の構造体オブジェクトを参照することで、構造体の強力な意図しない複製を回避するには、このチェック ボックスをオフにします。

  例

  コードに次の class と struct が存在すると想定します。

  public struct CustomStruct
  {
      private int Count;
  
      public int Bump => ++Count;
  }
  
  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         i += cs.Bump;   // select this line
      }
  }
  

  [カスタム構造体に ref または out を配置しない] オプションをオフにすると、"Extract メソッド" 機能によって次の結果が生成 されます。

  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         NewMethod(ref cs, ref i);
      }
  
      private static void NewMethod(ref CustomStruct cs, ref int i)
         => i += cs.Bump;
  }
  

  [カスタム構造体に ref または out を配置しない] オプションを オンにすると、"Extract メソッド" 機能によって次の結果が生成されます。

  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         i = NewMethod(cs, i);
      }
  
      private static int NewMethod(CustomStruct cs, int i)
      {
         i += cs.Bump;
         return i;
      }
  }
  

インライン ヒント

• インライン パラメーター名のヒント

  選択すると、関数呼び出しの各引数の前に、リテラル、キャスト リテラル、およびオブジェクトインスタンス化のパラメーター名ヒントが挿入されます。

  

• インライン型ヒント

  選択すると、推論された型とラムダ パラメーター型を持つ変数の型ヒントが挿入されます。

  

継承の余白

• 選択すると、コードの実装とオーバーライドを表す余白にアイコンが追加されます。 継承余白アイコンをクリックすると、移動する継承オプションが表示されます。

  

こちらも参照ください

• 方法: ドキュメント生成用に XML コメントを挿入する
• XML コメントを使用してコードを文書化する (C# ガイド)
• 言語固有のエディター オプションを設定する
• C# IntelliSense