ReSharper 2024.1 ヘルプ

XML ドキュメントコメントを再フォーマットする

ReSharper はあなたの好みに従って XML ドキュメントのコメントを再フォーマットすることができます。

ReSharper は、次のようなプレーンコメントを再フォーマットしないことに注意してください。

// A plain single-line comment

または

/* A plain multi-line comment */

XML ドキュメントコメントを再フォーマットするには、コードクリーンアップを使用します。組み込みプロファイルビルトイン: フルクリーンアップを使用してコードクリーンアップ実行するか、特定のタスクのみを対象としたカスタムプロファイルを使用してコードクリーンアップ実行できます。

カスタムコードクリーンアッププロファイルを使用して XML ドキュメントコメントを再フォーマットする

  1. メインメニューから ReSharper | オプションを選択するか、Alt+R O を押します。

  2. コード編集 | XML 文書コメント | スタイルのフォーマットページで、あなたのコーディング慣行や標準に準拠するようにフォーマット設定を構成します。

  3. クリーンアッププロファイル設定ページに移動します: コード編集 | コードのクリーンアップ | プロファイル

  4. 新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って、新しいプロファイルを作成します。新しいプロファイルの選択したプロファイル設定セクションで、C#、VB.NET、JavaScript で使用できる埋め込み XML ドキュメントコメントの再フォーマットチェックボックスを選択します。必要に応じて、このプロファイルで他のコードクリーンアップタスクを有効にすることができます。

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

  6. XML 文書のコメントを再フォーマットする範囲を選択します。

    • XML ドキュメントコメントをファイルに再フォーマットするには、ファイル内の任意の場所にキャレットを置きます。

    • ソリューションエクスプローラーの 1 つまたは複数の項目を選択して、これらのノードおよびその子項目にあるファイル内の XML 文書コメントを再フォーマットします。

  7. 以下のいずれか 1 つを実行します:

    • Control+Alt+F を押すか、メインメニューから ReSharper | 編集 | コードのクリーンアップ…を選択します。

    • テキストエディターの任意の場所を右クリックするか、選択項目を右クリックし、コンテキストメニューでコードのクリーンアップを選択します。

  8. 開いたコードのクリーンアップダイアログで、新しく作成したプロファイルを選択します。

  9. 実行をクリックします。ReSharper は、選択したスコープ内の XML 文書コメントを再フォーマットします。

コードクリーンアップダイアログを開いてプロファイルを選択せずに XML ドキュメントコメントを再フォーマットする場合は、デフォルトのコードの整形プロファイルをサイレントクリーンアップにバインドし、Control+Shift+Alt+F を押して実行できます。XML ドキュメントコメントの再フォーマットと他のコードスタイルタスクを組み合わせたカスタムクリーンアッププロファイルを作成することもできます。

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

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

関連ページ:

コードのクリーンアップ

ReSharper を使用すると、フォーマットやその他のコードスタイル設定を一括モードで適用して、1 つ以上のファイル、プロジェクト、ソリューション全体でコードスタイル違反を即座に排除できます。コードクリーンアッププロファイル:コードのクリーンアップには、ニーズに応じてさまざまな場合に適用できるさまざまな設定(プロファイル)があります。提供時の状態で使用可能な 3 つのデフォルトプロファイルがあります。コードのフォーマットのみを適用するビルトイン: コードの整形、コードのフォーマットとコードの...

ReSharper 設定の管理と共有

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

コードインスペクション設定を構成する

設計時コードインスペクションを構成する:デフォルトでは、ReSharper は、サポートされている言語に対応するすべてのファイルで設計時コードインスペクションを有効にします。必要に応じて、無効にすることができます。設計時コードインスペクションが有効かどうかに関係なく、コードインスペクションは常に特定のスコープで実行できます。メインメニューからを選択するか、Alt+R O を押してから、左側のを選択します。設計時コードインスペクションを切り替えるには、コード分析を有効にするチェックボックスを使用し...

さまざまな言語の ReSharper 機能

以下の表は、各 ReSharper 機能がサポートされている言語 / テクノロジーを説明しています。これらは言語固有の機能のみをリストし、プロジェクト依存関係ダイアグラム、名前空間の調整リファクタリング、スタックトレースエクスプローラーなどのプロジェクト / ソリューションスコープの多くの機能を含まず、最近のファイルを表示します。コード解析:コードインスペクション

ASP.NET MVC 特有の機能

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

言語による ReSharper: MS ビルド

MSBuild は、アプリケーションを構築するために広く使用されているプラットフォームです。特定の XML タグを使用して、プロジェクトの構築方法や実行方法を定義できます。ReSharper を使用すると、より速く行うことができます。コード検査:あらかじめ定義された要素またはその属性の名前を誤って入力した場合、ReSharper はそのような不一致についてハイライト表示します。まだ定義されていないプロパティを参照しようとすると、ReSharper はそのようなケースも検出します。MSBuild...