ReSharper 2024.1 ヘルプ

コード構文スタイル: ファイルスコープの名前空間

C# 10 以降、単一の名前空間を含むファイルでファイルスコープの名前空間宣言を使用できます。

ファイルスコープまたはブロックスコープの名前空間宣言に固執する場合、ReSharper を使用すると、環境設定を構成し、コードベース全体で環境設定の一貫性を維持できます。

ReSharper は、既存のコードでファイルスコープの名前空間の設定を適用するのに役立ち、コード補完コード生成機能を備えた新しいコードを生成し、コードテンプレート を適用し、リファクタリングを実行するときに設定を考慮に入れます。

ファイルスコープの名前空間の設定を適用する

ReSharper は、ファイル内の単一の名前空間が設定に準拠しているかどうかを確認できます。準拠していない場合は、そのような宣言をハイライトし、対応するクイックフィックスまたはスコープ内の修正を提案します。デフォルトの ReSharper の設定では、ファイルスコープの名前空間が優先されます。

ReSharper: 'To file-scoped namespace' quick-fix

しかし、設定でき嗜好を ReSharper は、既存のファイルスコープの名前空間のブロックスコープを作る提案別の方法で:

ReSharper. 'To block-scoped namespace' quick-fix

バルクモードでファイルスコープの名前空間の設定を強制する別のオプションは、コードのクリーンアップです。組み込みプロファイルフルクリーンアップまたは再フォーマットして構文スタイルを適用のいずれかを使用してコードクリーンアップを実行するか、以下で説明するように、特定のタスクのみを対象としたカスタムプロファイルを作成して実行できます。

カスタムコードクリーンアッププロファイルを使用して、ファイルスコープの名前空間に設定を適用する

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

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

  3. 新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って、新しいプロファイルを作成します。新しいプロファイルの選択したプロファイル設定セクションで、名前空間を配置します(ファイルスコープとブロックスコープチェックボックスをオンにします。必要に応じて、このプロファイルで他のコードクリーンアップタスクを有効にすることができます。

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

  5. 設定を適用する範囲を選択します。

    • ファイル内の任意の場所にキャレットを配置して、ファイルに設定を適用します。

    • ソリューションエクスプローラー内の 1 つまたは複数の項目を選択して、これらのノードおよびその子項目にあるファイルに設定を適用します。

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

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

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

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

  8. 実行をクリックします。ReSharper は、選択した範囲であなたの設定を強制します。

コードクリーンアップダイアログを開いてプロファイルを選択せずに、ファイルスコープの名前空間の設定を強制する場合は、作成したプロファイルをサイレントクリーンアップにバインドし、Control+Shift+Alt+F を押して実行できます。設定の適用と他のコードスタイルタスクを組み合わせたカスタムクリーンアッププロファイルを作成することもできます。

選択したコードブロック Alt+Enter に、他のすべてのフォーマットおよび構文スタイルの規則とともにファイルスコープの名前空間の設定を適用するには、再フォーマットとクリーンアップ | 構文スタイルを再フォーマットして適用するを選択します。

変更をファイルに保存するたびに、ファイルスコープの名前空間の設定を適用して、編集が常にコードスタイルに準拠するようにすることができます。

変更を保存するときに、ファイルスコープの名前空間の設定を自動的に適用する

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

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

  3. カスタムコードクリーンアッププロファイルを選択し、デフォルトに設定をクリックします(デフォルトプロファイルはサイレントクリーンアップにも使用されます)。

  4. コード編集 | コードのクリーンアップ | 一般オプションページに移動し、ファイルの保存時にクリーンアップを自動的に実行するを選択します。

    オプションで、ファイルマスクによって特定のファイルへの自動クリーンアップを制限できます。ファイルの変更された部分のみを選択して、変更によって影響を受けるコードにクリーンアップが適用され、ファイル内の残りのコードが変更されないようにすることもできます。

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

  6. 次回編集を終了してファイル (Ctrl+S) またはすべてのファイル (Ctrl+Shift+S) を保存すると、ReSharper は選択したプロファイルを使用して影響を受けるファイルをクリーンアップします。デフォルトのクリーンアッププロファイルが選択されていない場合、ReSharper はプロファイルの 1 つを選択するよう求めます。

ファイルスコープの名前空間の設定を構成する

名前空間宣言スタイルの設定は、レイヤーベースの設定のメカニズムを使用して保存されます。特に、このメカニズムを使用すると、さまざまなソリューションのさまざまな設定を維持したり、これらの設定を VCS で維持したり、チームメンバーと自動的に共有したりできます。

オプションで名前空間宣言スタイルを構成する

  1. ReSharper オプション Alt+R, Oコード編集 | C# | 構文スタイルページに移動します。

  2. コード本体にある名前空間オプションを見つけて、ファイルスコープまたはブロックスコープを選択します。

  3. 右側の列の通知するセレクターを使用して、設定とは異なるコードインスペクション検出コードの重大度レベルを設定できます。

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

また、対応する問題がハイライトされているエディターで、名前空間宣言の設定を変更することもできます。

エディターから名前空間宣言スタイルの設定を変更する

  1. ReSharper のインスペクションでハイライトされているコードの問題にキャレットを置きます。

  2. Alt+Enter を押すか、キャレットの左側にあるアクションインジケーターをクリックして、アクションリストを開きます。

  3. アクションリストでインスペクション " 優先される名前空間本体スタイルを使用します ..." | コードスタイルを設定するを選択し、希望の設定を選択します。

    ReSharper: Changing code style preference for namespace body
  4. 変更は、スマートセーブロジックを使用して保存されます。

  5. 変更したスタイル設定を共有設定レイヤーに保存する必要がある場合は、コードスタイルを設定するメニュー項目をクリックするか、選択時に Enter を押します。ReSharper により、ReSharper オプションのコード編集 | C# | 構文スタイルページが開きます。必要に応じて設定を変更し、保存先をクリックして、目的の設定レイヤーを選択します。

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

関連ページ:

プロジェクト固有のプロパティを構成する

ReSharper の設定のメインセット(ReSharper | オプションダイアログで設定)は、グローバルまたはソリューションごとに適用されます。各プロジェクトまたはフォルダーごとに個別に設定できる環境設定もあります。これらの設定は、プロジェクトアイテムのプロパティポップアップで利用できます。プロジェクトアイテムのプロパティポップアップは、ソリューションエクスプローラーでプロジェクトのコンテキストメニューからプロジェクト項目のプロパティを編集するを選択して呼び出すことができます。他の ReSh...

コード補完 (IntelliSense)

ReSharper は、高度な機能を備えた Visual Studio のネイティブコード補完(IntelliSense)を補完し、拡張します。例: あなたの入力に基づいて提案のリストを絞り込み、選択した型と拡張メソッドを自動的にインポートし、メソッド名を補完するときに括弧を追加し、型に応じて変数とフィールド名を提案するなど。ReSharper のコード補完の機能に慣れ親しむために、いくつかの実装の基本があります: デフォルトでは、ReSharper は Visual Studio のネイティブの...

設計時にコードの問題を分析する

ReSharper は、エディターでコードファイルを開くとすぐに分析を開始し、最後まで編集を続けます。検出されたすべてのコードの問題は、重大度に従ってエディターでハイライトされます。問題のマップは、エディターウィンドウの右側のマーカーバーにも表示されます。ここでは、ファイルのステータスを即座に確認し、マークをクリックして特定のコードの問題に移動できます。デザインタイムインスペクションの機能:ReSharper によって実行されるデザインタイムコードインスペクションを説明するために、エディターに...

スコープを修正

ほとんどのクイックフィックスは、キャレットで現在の問題を修正できますが、中には (たとえば、未使用のディレクティブを削除する、フィールドを読み取り専用にする、冗長なキャストの除去など)、現在のファイル、現在のプロジェクト、ソリューション全体など、より大きな範囲で問題を自動的に見つけて修正できるものもあります。範囲内の修正を適用する:このような修正は、アクションリストの横に表示される小さな矢印で識別できます。範囲内の修正を適用する ReSharper のインスペクションでハイライトされているコード...

コンテキストアクション

コンテキストアクションは、エディターで直接利用できるコード変換ヘルパーです。クイックフィックスとは対照的に、コンテキストアクションは問題の解決やコードの改善を目的としているためはなく、アクセス修飾子の変更、null をチェックするコードの生成、'foreach' の 'for' への変換などの小さな変更を素早く導入できます。ReSharper は、サポートされているすべての言語で数百のコンテキストアクションを提供します。完全なリストは、ReSharper オプション Alt+R, O のページとコン...

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

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