コード構文スタイル: ファイルスコープの名前空間
C# 10 以降、単一の名前空間を含むファイルでファイルスコープの名前空間宣言を使用できます。
ファイルスコープまたはブロックスコープの名前空間宣言に固執する場合、ReSharper を使用すると、環境設定を構成し、コードベース全体で環境設定の一貫性を維持できます。
ReSharper は、既存のコードでファイルスコープの名前空間の設定を適用するのに役立ち、コード補完とコード生成機能を備えた新しいコードを生成し、コードテンプレート を適用し、リファクタリングを実行するときに設定を考慮に入れます。
ファイルスコープの名前空間の設定を適用する
ReSharper は、ファイル内の単一の名前空間が設定に準拠しているかどうかを確認できます。準拠していない場合は、そのような宣言をハイライトし、対応するクイックフィックスまたはスコープ内の修正を提案します。デフォルトの ReSharper の設定では、ファイルスコープの名前空間が優先されます。
しかし、設定でき嗜好を ReSharper は、既存のファイルスコープの名前空間のブロックスコープを作る提案別の方法で:
バルクモードでファイルスコープの名前空間の設定を強制する別のオプションは、コードのクリーンアップです。組み込みプロファイルフルクリーンアップまたは再フォーマットして構文スタイルを適用のいずれかを使用してコードクリーンアップを実行するか、以下で説明するように、特定のタスクのみを対象としたカスタムプロファイルを作成して実行できます。
カスタムコードクリーンアッププロファイルを使用して、ファイルスコープの名前空間に設定を適用する
メインメニューから Alt+R O を押します。
を選択するか、クリーンアッププロファイル設定ページに移動します:
。新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って、新しいプロファイルを作成します。新しいプロファイルの選択したプロファイル設定セクションで、名前空間を配置します(ファイルスコープとブロックスコープチェックボックスをオンにします。必要に応じて、このプロファイルで他のコードクリーンアップタスクを有効にすることができます。
オプションダイアログで保存をクリックして変更を適用し、ReSharper に変更を保存する場所を選択させるか、保存先セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「resharper 設定の管理と共有」を参照してください。
設定を適用する範囲を選択します。
ファイル内の任意の場所にキャレットを配置して、ファイルに設定を適用します。
ソリューションエクスプローラー内の 1 つまたは複数の項目を選択して、これらのノードおよびその子項目にあるファイルに設定を適用します。
以下のいずれか 1 つを実行します:
Control+Alt+F を押すか、メインメニューから
を選択してください。テキストエディターの任意の場所を右クリックするか、選択項目を右クリックし、コンテキストメニューでコードのクリーンアップを選択します。
開いたコードのクリーンアップダイアログで、新しく作成したプロファイルを選択します。
実行をクリックします。ReSharper は、選択した範囲であなたの設定を強制します。
コードクリーンアップダイアログを開いてプロファイルを選択せずに、ファイルスコープの名前空間の設定を強制する場合は、作成したプロファイルをサイレントクリーンアップにバインドし、Control+Shift+Alt+F を押して実行できます。設定の適用と他のコードスタイルタスクを組み合わせたカスタムクリーンアッププロファイルを作成することもできます。
選択したコードブロック Alt+Enter に、他のすべてのフォーマットおよび構文スタイルの規則とともにファイルスコープの名前空間の設定を適用するには、 を選択します。
変更をファイルに保存するたびに、ファイルスコープの名前空間の設定を適用して、編集が常にコードスタイルに準拠するようにすることができます。
変更を保存するときに、ファイルスコープの名前空間の設定を自動的に適用する
メインメニューから Alt+R O を押します。
を選択するか、クリーンアッププロファイル設定ページに移動します:
。カスタムコードクリーンアッププロファイルを選択し、デフォルトに設定をクリックします(デフォルトプロファイルはサイレントクリーンアップにも使用されます)。
ファイルの保存時にクリーンアップを自動的に実行するを選択します。
オプションページに移動し、オプションで、ファイルマスクによって特定のファイルへの自動クリーンアップを制限できます。
ファイルの変更された部分のみを選択して、変更によって影響を受けるコードにクリーンアップが適用され、ファイル内の残りのコードが変更されないようにすることもできます。
ファイルの変更された部分のみをクリーンアップすることを選択した場合は、次のオプションを使用してこの動作を微調整できます。
部分的なクリーンアップが不可能な場合は完全なクリーンアップを実行する — このオプションに応じて、ReSharper はファイル全体をクリーンアップするか、ファイルの変更された部分のみにクリーンアップを制限できない場合はファイルをスキップします。
共有ファイルの保存時にクリーンアップを許可する — このオプションを使用して、共有プロジェクトのファイルなど、ソリューションに複数回含まれるファイルの部分的なクリーンアップを有効または無効にします。
ダイアログで保存をクリックして変更を適用し、ReSharper に変更を保存する場所を選択させるか、保存先セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「resharper 設定の管理と共有」を参照してください。
次回編集を終了してファイル (Ctrl+S) またはすべてのファイル (Ctrl+Shift+S) を保存すると、ReSharper は選択したプロファイルを使用して影響を受けるファイルをクリーンアップします。デフォルトのクリーンアッププロファイルが選択されていない場合、ReSharper はプロファイルの 1 つを選択するように求めます。
ファイルスコープの名前空間の設定を構成する
名前空間宣言スタイルの設定は、レイヤーベースの設定のメカニズムを使用して保存されます。特に、このメカニズムを使用すると、さまざまなソリューションのさまざまな設定を維持したり、これらの設定を VCS で維持したり、チームメンバーと自動的に共有したりできます。
オプションで名前空間宣言スタイルを構成する
ReSharper オプション Alt+R, O の ページに移動します。
コード本体にある名前空間オプションを見つけて、ファイルスコープまたはブロックスコープを選択します。
右側の列の通知するセレクターを使用して、設定とは異なるコードインスペクション検出コードの重大度レベルを設定できます。
オプションダイアログで保存をクリックして変更を適用し、ReSharper に変更を保存する場所を選択させるか、保存先セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「resharper 設定の管理と共有」を参照してください。
また、対応する問題がハイライトされているエディターで、名前空間宣言の設定を変更することもできます。
エディターから名前空間宣言スタイルの設定を変更する
ReSharper のインスペクションでハイライトされているコードの問題にキャレットを置きます。
Alt+Enter を押すか、キャレットの左側にあるアクションインジケーターをクリックして、アクションリストを開きます。
アクションリストでインスペクション " 優先される名前空間本体スタイルを使用します ..." | コードスタイルを設定するを選択し、希望の設定を選択します。
変更は、スマートセーブロジックを使用して保存されます。
変更したスタイル設定を共有設定レイヤーに保存する必要がある場合は、コードスタイルを設定するメニュー項目をクリックするか、選択時に Enter を押します。ReSharper により、ReSharper オプションの ページが開きます。必要に応じて設定を変更し、保存先をクリックして、目的の設定レイヤーを選択します。
この機能は、次の言語とテクノロジーでサポートされています。
関連ページ:
プロジェクト固有のプロパティを構成する
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 を押してから、左側のを選択します。設計時コードインスペクションを切り替えるには、コード分析を有効にするチェックボックスを使用し...