ReSharper 2024.3 ヘルプ

やることリスト

ReSharper は、コード内のタスクと技術的負債(英語)を追跡する簡単な方法を提供します。特定のパターンに一致するコード項目 (コメント、文字列リテラル、識別子) は、エディター内だけでなく、To-do エクスプローラーを使用してソリューション全体でも簡単に見つけることができます。ウィンドウ。

ReSharper: To-do explorer

To Do アイテムは、その種類(編集、通常、質問、警告、エラー)に応じて、エディターとマーカーバーでハイライトされます。Visual Studio オプションの環境 | フォントおよび色ページで色を設定できます。

Configuring editor and marker bar colors for ReSharper's To-do items

To-do パターン

デフォルトでは、ReSharper は、以下のタイプの To-Do アイテムによく使用される 3 つの定義済みパターンを提供します。

  • コメント内の TODO または TODO: some description を含む行 (どちらも大文字と小文字を区別しない) - 標準

  • コメント内の BUG: を含む行 (大 / 小文字の区別) - エラー

  • コード内の NotImplementedException - 編集

独自のパターンを定義して、To Do エクスプローラーウィンドウで特定の技術的負債項目にすばやくアクセスすることもできます。

カスタム To-Do パターンを定義する

  1. ReSharper オプション Alt+R, Oツール | To-do エクスプローラーページを開きます。

  2. ツールバーの追加をクリックします。

  3. To-do パターンのタイトルを指定し、コメントで検出したいキーワードを含む正規表現を指定します。例: (\W|^)(?<TAG>Refactor)(\W|$)(.*)

  4. To-do アイテム(コメント、文字列、/ または識別子)を検索するために ReSharper が式を適用する場所を選択します。

  5. 必要に応じて、パターンで大文字と小文字を区別するかどうかを指定します。

  6. パターンのタイプを選択して、エディターおよび To-do エクスプローラーウィンドウで一致したアイテムをどのように色付けするかを定義します。

  7. このパターンをリストに追加するには、OK をクリックします。

  8. 既存のパターンを複製、編集、削除することもできます。

  9. オプションダイアログで保存をクリックして変更を適用し、ReSharper に変更を保存する場所を選択させるか、保存先セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「resharper 設定の管理と共有」を参照してください。

コメント内の複数行の ToDo 項目

デフォルトでは、次の行が最初の行から少なくとも 1 つの空白でインデントされている場合、コメント内の To-do 項目は複数行にすることができます。

// TODO: beginning of the comment, // comment continued on the next line

コメントに 1 行の ToDo 項目のみを表示したい場合は、ReSharper オプション Alt+R, Oツール | To-do エクスプローラーページで次の行のインデントされたテキストを同じ ToDo の一部として扱うをクリアします。

コメント内の複数行の To-do 項目が有効になっている場合、複数行の項目をそのまま表示するか、複数行の項目全体を 1 行に表示するかを選択できます。これを行うには、To-do エクスプローラーツールバーの複数行のプレゼンテーションを有効にするボタンを使用します。

ReSharper Enable multiline presentation or To-do items

To Do アイテムを外部 URL にリンクする

予定パターンでは、外部 URL を指すアイテムのプレースホルダーを追加できます。これは issue tracker に特に便利です - あなたのコメントで issue の ID を使うことができ、ReSharper は直接ブラウザーまたはエディターのピークビューで対応する issue を開くことを可能にします。

プロジェクトが GitHub にあり、コードに GitHub の問題に関するコメントを追加したいとします。そのためには、カスタム To-do パターンを作成するを実行するだけです。

  • 正規表現: (?<=\W|^)(?<TAG>GH \#(?<ISSUE_ID>\d+))(\W|$)(.*)

  • URL: https://github.com/<YOUR_PROJECT>/issues/${ISSUE_ID}

ReSharper. To-do pattern that recognizes GitHub issues

ReSharper はあなたのコメントにある GH #XX を対応する GitHub の問題へのリンクとして扱います。

ReSharper. To-do link to GitHub issue from the comment

これらのコメントを Ctrl でクリッキングするだけでなく、Ctrl+Shift をクリックしてエディターのプレビュープレビューでリンクを開くこともできます。URL に移動する両方の方法は、Alt+Enter メニューからも利用できます。

現在のファイルの To Do アイテム間を移動するには、マーカーバーの To Do マークを使用します。

ソリューション全体で To-Do 項目を検討する

  1. Control+Alt+. を押すか、メインメニューから ReSharper | Windows | To-do エクスプローラーを選択します。あるいは、Control+Shift+A を押して、ポップアップでコマンド名を入力して、そこで選択することもできます。

  2. 開いた To-do エクスプローラーウィンドウで、ThemedIcon.Down.Screen.(Gray).png または ThemedIcon.Up.Screen.(Gray).png をクリックして、次または前の項目に移動します。

    エディターで ToDo アイテムを見つけるには、ダブルクリックします。

    Viewing To-do items with ReSharper
  3. ウィンドウ内で選択したアイテムのソースコードを調べるには、ツールバーのプレビューの表示 ThemedIcon.PreviewToggle.Screen.(Gray).png をクリックします。必要に応じて、プレビューペインを下部または右側に配置できます。

To Do アイテムのグループ化とフィルター

デフォルトでは、To-Do エクスプローラーはプロジェクト構造に基づいて To-Do 項目をリストします。必要に応じて、グループ化セレクターを使用してグループ化オプションを変更できます。グループ化を無効にしたり、タグ、タイプ、名前空間、ディレクトリ、プロジェクトごとにグループ化したりできます。

コードベースのサイズと年齢によっては、やること項目がたくさんある場合があります。特定のアイテムに焦点を合わせるために、パターン(たとえば、TODO または BUG)で To Do アイテムをフィルタリングできます。フィルター ThemedIcon.Filter.Screen.(Gray).png セレクターで目的のパターンを選択するだけで、対応するパターンに一致するアイテムを表示し、他のすべてを非表示にします。

To do Explorer ウィンドウのツールバーコントロール

コントロール

名前

説明

ThemedIcon.ExpandAll.Screen.(Gray).png ThemedIcon.CollapseAll.Screen.(Gray).png

すべて展開 / すべて折りたたむ

現在のタブのすべてのノードを展開 / 折りたたみます。

ThemedIcon.Up.Screen.(Gray).png ThemedIcon.Down.Screen.(Gray).png

/ 次へ


Shift+F8 / F8

前 / 次の項目に移動し、それに応じてソースコードをスクロールします。

ThemedIcon.PreviewToggle.Screen.(Gray).png

プレビューの表示 Ctrl+P

リストを使用して指定された位置(ウィンドウの下部または右側)にある選択されたアイテムのプレビューでペインを非表示または表示します。

ThemedIcon.Export.Screen.(Gray).png

エクスポート

このボタンをクリックして、現在ウィンドウに表示されているデータをテキスト形式でエクスポートするか、ドロップダウンセレクタを使用してデータを XML または HTML 形式でエクスポートします。表示されるデータのエクスポートダイアログを使用すると、データをファイルに保存したり、クリップボードにコピーしたりできます。

ThemedIcon.Settings.Screen.(Gray).png

やるべき設定

To-Do アイテムのパターンを管理できる ReSharper オプションのツール | To-do 項目ページを開きます。

ThemedIcon.Highlighting.Screen.(Gray).png

アイテムをペイントする

種類(編集、標準、質問、警告、エラー)に従ってウィンドウ内のタスク項目の色付けを切り替えます。色は、Visual Studio のオプションの環境 | フォントおよび色ページで設定できます。

Configuring editor and marker bar colors for ReSharper's To-do items

Enable multiline presentation

複数行のプレゼンテーションを有効にする

コメント内の複数行の ToDo 項目が有効になっている場合は、このボタンを使用して、複数行項目をそのまま表示するか、複数行項目全体を 1 行に表示するかを選択します。

ThemedIcon.GeneratedCode.Screen.(Gray).png

生成コードに To Do 項目を表示する

生成されたコードでタスク項目を表示または非表示にすることができます。ReSharper オプションのコードインスペクション | 生成されたコードページで、生成されたコードを含むファイルとリージョンのリストを設定できます。

フィルター

このリストを使用してフィルターを選択し、対応するパターンのみに関連するアイテムを表示します。デフォルトでは、5 つのフィルターが提供されています。

  • (すべて)

  • トドス

  • ノート

  • バグ

  • 実装なし

グループ化

このリストを使用して、To Do アイテムをグループ化するための条件を選択します。いくつかのオプションが提供されます。

  • なし - アイテムはプレーンリストとして表示されます。

  • タイプ - アイテムは、タイプを含むことによってグループ化されます。

  • 名前空間 - アイテムは名前空間ごとにグループ化され、ネスト構造は考慮されずに、プレーンリストとして表示されます。

  • 名前空間とタイプ - 項目は名前空間によってグループ化され、下位レベルではそれらが遭遇するクラスによってグループ化されます。

  • ディレクトリ - アイテムは、それらが保存されているディレクトリによってグループ化されます。ディレクトリは、ネスト構造が考慮されていないプレーンリストとして表示されます。

  • ファイル - アイテムは、含まれているファイルごとにグループ化されます。

  • ディレクトリとファイル - アイテムはそれらが格納されているディレクトリによって、下位レベルではそれらを含んでいるファイルによって、グループ化されています。ディレクトリは単純なリストとして表示され、ネスト構造は考慮されません。

  • プロジェクト - アイテムは、含まれているプロジェクトごとにグループ化されます。

  • プロジェクトと種類 - 項目はプロジェクトを含むことによって分類され、下位レベルではタイプによって分類されます。

  • プロジェクトとディレクトリ - 項目はプロジェクトを含むことによって、より低いレベルではディレクトリによって分類されます。プロジェクト内では、ディレクトリは単純なリストとして表示され、ネスト構造は考慮されません。

  • プロジェクト構造 - 項目はプロジェクトの物理的構造に従ってグループ化され、すべてのネスト関係が表されます。

この機能は、次の言語とテクノロジーでサポートされています。

ここで説明する手順と例では、C# の機能の使用について説明します。他の言語の詳細については、言語およびフレームワークセクションの対応するトピックを参照してください。

関連ページ:

ブックマーク

後でコード内のある場所に戻りたい場合は、ソリューション内またはライブラリコード内の任意のコード行をブックマークでマークできます。使用できるブックマークには次の 2 種類があります。ニーモニックのブックマーク — 現在のソリューションの上位 10 位など、頻繁に参照するコード行をマークするのに最も役立ちます。最大 10 個の番号付きブックマークを同時に持つことができます。それらは、左側のエディターガターにある次のアイコンで示されます: この種のブックマークには専用のショートカットを使用してください。C...

マーカーバーとステータスインジケーター

マーカーバーとステータスインジケーターは、現在のファイルの設計時コードインスペクションの結果を視覚化し、コードの問題間を移動できます。また、マーカーバーには、ハイライトされた使用箇所など、他の機能の特別なマークが表示されます。マーカーバー:マーカーバー (別名「エラーストライプ」) は、エディターのスクロールバーに統合されているか、スクロールバーの右側に表示されるサイドバーです。次の項目を個別のマーカーとして表示できます。ReSharper の設計時インスペクションによって発見されたコードの問題...

ライブ / 囲みテンプレートを作成する

ライブ / 囲みテンプレートは、既存のファイルにコードを生成したり、(テンプレート本体にパラメーターがある場合)ステートメントなどのテンプレートコードでコードフラグメントを囲むために使用できます。各ライブテンプレートは、ショートカット(などの短い文字列)によって識別されます。この文字列をエディターに直接入力して、テンプレートを呼び出すことができます。ライブ / 囲みテンプレートは、単体テスト用のクラス、DTO、スケルトンの作成など、さまざまな用途に使用できます。ライブ / 囲みテンプレートの本体...

ReSharper 設定の管理と共有

ReSharper は、階層化された設定のメカニズムを使用して環境設定を保存するため、次の利点があります。さまざまなソリューションで異なる設定を行うことができます。環境設定のさまざまなサブセットを別の場所に保存し、特定のソリューションで作業するときに環境設定を組み合わせることができます。例: 記号のアイコンとチーム設定のコード形式を個人設定で保存し、これらの設定を自動的に組み合わせることができます。設定の特定のサブセットを VCS に保持することにより、チーム内の設定を同期できます。ReShar...

構造検索と置換

場合によっては、正規表現に一致する特定のシンボルやテキストの出現を検索するなどの標準的な検索方法では、目的の結果が得られない場合があります。例: プロジェクトに固有のコードの匂いを見つけたり、リファクタリングする必要があるコードを見つける必要があるかもしれません。ReSharper を使用すると、特定のパターンに一致するコードブロックを検索し、必要に応じて置き換えることができます。これらのブロックはまったく異なる場合があります。異なるタイプ、式、ステートメントなどを含むことができますが、論理的に...

ASP.NET MVC 特有の機能

ReSharper には、一般的な ASP.NET 機能に加えて、ASP.NET MVC での作業をより簡単にサポートする特殊機能があります。構文のハイライト:ASP.NET MVC メソッド呼び出しとパラメーターの特別な構文のハイライト: コード補完:文字列リテラルでアクションとコントローラーを参照するための専用コード補完: ナビゲーションと検索:さまざまなナビゲーション機能がアクションとコントローラーでも機能します。コード生成:使用箇所から新しいコントローラーとアクションを作成する: 最終...