コードの構文スタイル: 1 つのネストされた文に対する波括弧
C# 仕様では、 if-else、 foreach など、一部の親ステートメントにある単一のネストされたステートメントを囲む中括弧を安全に省略できます。 ただし、コードスタイルのガイドラインはこの点で異なる場合があります。 ここで中括弧を要件と見なす人もいれば、冗長であると考える人もいます。 どのスタイルを好む場合でも、重要なことは、コードベース全体で中括弧を一貫して使用することです。 JetBrains Rider を使うと、各種コードブロックの後に中括弧を使うかどうかの環境設定を定義し、このスタイルを強制できます。
JetBrains Rider は、波かっこレイアウト（空白、タブ、新しい行）のための複数の フォーマット規則も提供しています。 これらのルールは Rider の設定 Ctrl+Alt+S で構成できます。例えば、 ページに進み、 波括弧レイアウト タブで環境設定を確認します。
JetBrains Rider は既存のコードにブレーススタイルを適用し、新しいコードを コード補完や コード生成機能で作成する際に環境設定を考慮します。また、 コードテンプレートを適用し、 リファクタリングも実行します。
ブレースにスタイル設定を適用する
デフォルトでは、すべての関連する コードインスペクションが無効になっているため、JetBrains Rider は単一の入れ子ステートメントに対して中括弧に何も行いません。 そのため、JetBrains Rider に単一の入れ子ステートメントのスタイル環境設定を管理させ、好みに違反した場合に通知させたい場合は、まず 環境設定を構成してください。
JetBrains Rider は、環境設定に準拠しないコードを ハイライトし、対応する クイックフィックスまたは スコープで修正を提案します。 例: using にブレースを使うことを選ぶことができます:
単一ステートメントのブレースに関する設定を一括で適用するもう一つの方法は、 コードのクリーンアップです。 組み込みプロファイル フルクリーンアップまたは 再フォーマットして構文スタイルを適用のいずれかを使用して コードクリーンアップを実行するか、後述するように、特定のタスクのみを対象とした カスタムプロファイルを作成して実行することができます。
カスタムコードクリーンアッププロファイルでブレースの設定を適用する
Ctrl+Alt+S を押すか、メニューから (Windows および Linux) または (macOS) を選択します。
クリーンアッププロファイル設定ページに移動します: 。
新しいカスタムクリーンアッププロファイルを作成する セクションの説明に従って、新しいプロファイルを作成します。 右側のプロファイル設定で、 ノードを展開し、 シングルステートメント用の波括弧の追加 / 削除 ... チェックボックスをオンにします。
設定 ダイアログで 保存 をクリックして変更を適用し、JetBrains Rider が保存先を選択できるようにするか、 保存 セレクターからレイヤーを選んで特定の設定レイヤーに変更を保存します。 詳細については、「レイヤーベースの設定 」を参照してください。
設定を適用する範囲を選択します。
ファイル内の任意の場所にキャレットを配置して、ファイルに設定を適用します。
ソリューションエクスプローラー 内の 1 つまたは複数の項目を選択して、これらのノードおよびその子項目にあるファイルに設定を適用します。
Ctrl+R, C を押すか、メインメニューから を選択してください。
表示された 整形とクリーンアップ ダイアログで、新しく作成したプロファイルを選択し、必要なら別のスコープを選択してください。 。
OK をクリックします。 JetBrains Rider は選択したスコープ内で環境設定を適用します。
プロファイルを選択するために 整形とクリーンアップ ダイアログを開かずにブレースの設定を適用したい場合は、作成したプロファイルを サイレントクリーンアップにバインドし、 Ctrl+R, G を押すことで実行できます。 設定の適用と他のコードスタイルタスクを組み合わせた カスタムクリーンアッププロファイルを作成することもできます。
選択したコードブロックに、他のすべての フォーマットや 構文スタイルルールと一緒にオプションのブレース設定を適用するには、 Alt+Enter を実行し、 を選択します。
最近変更して Git にコミットしようとしているコードに中括弧スタイルを適用できます。 JetBrains Rider は、コミットする前に選択した クリーンアッププロファイルを実行します。
Git にコミットする前にコードをクリーンアップする
Ctrl+K を押すか、メインメニューから を選択します。
コミット ツールウィンドウで
をクリックし、 コミットチェック 領域で クリーンアップ ... チェックボックスを選択します。プロファイルを選択 をクリックして、カスタムコードクリーンアッププロファイルを選択します。
コミット または コミットとプッシュ をクリックします。 JetBrains Rider はコミット用にステージングされたファイルでコードのクリーンアップを実行し、その後変更をコミットします。
変更をファイルに保存するたびに中括弧スタイルを適用して、編集内容が常にコードスタイルに準拠していることを確認できます。 ただし、これは Ctrl+S または Ctrl+S を使用して明示的に変更を保存した場合にのみ適用され、 auto-saving ではトリガーされません。 なお、自動保存されたファイルはすべて「再フォーマットとクリーンアップ」キューに配置され、次回の明示的な保存時に処理されます。
変更を保存するときに中括弧スタイルを自動的に適用する
Ctrl+Alt+S を押して設定を開き、 を選択します。
整形とクリーンアップ を選択し、カスタムコードクリーンアッププロファイルを選択して、それをファイル全体に適用するか、変更された行のみに適用するかを選択します。
次回、編集を終えてファイルまたはすべてのファイルを保存すると、JetBrains Rider は選択したプロファイルを使って対象ファイルをクリーンアップします。
単一ステートメントで中括弧の設定を構成する
ブレーススタイルの設定は、 レイヤーベース設定の仕組みを使って保存されます。 このメカニズムにより、さまざまなソリューションに対して異なる設定を維持したり、これらの設定をバージョン管理システム (VCS) で管理したり、チームメンバーと自動的に共有したりすることが可能になります。
ブレースの設定を構成する
JetBrains Rider 設定 Ctrl+Alt+S の ページに移動し、 構文スタイル タブを選択します。
波括弧 カテゴリの設定を、コーディングのプラクティス / 標準に従って変更します。
右列のセレクターを使うと、環境設定と異なるコードを検出する コードインスペクションの 重要度レベルを設定できます。
設定 ダイアログで 保存 をクリックして変更を適用し、JetBrains Rider が保存先を選択できるようにするか、 保存 セレクターからレイヤーを選んで特定の設定レイヤーに変更を保存します。 詳細については、「レイヤーベースの設定 」を参照してください。
対応する問題がハイライトされているエディター上でも、ブレースに関する設定を直接変更できます。
中括弧の設定をエディターから変更
JetBrains Rider のインスペクションでハイライトされているコードの問題にキャレットを置きます。
Alt+Enter を押すか、キャレットの左にある アクションインジケーターをクリックして、 アクションリストを開きます。
アクションリストで インスペクション " 中括弧を使用するかどうか ..." | コードスタイルを設定する を選択し、希望する設定を選択します:
変更は、 スマートセーブロジックを使用して保存されます。
変更したスタイル環境設定を 共有設定レイヤーに保存したい場合は、 コードスタイルを設定する メニュー項目をクリックするか、選択されているときに Enter を押します。 JetBrains Rider は 設定 の ページを開き、必要に応じて環境設定を変更できます。 保存先 をクリックし、希望する設定レイヤーを選択してください。
EditorConfig を介して構文スタイルの設定を行うことができます。 これらの設定は、ソリューション階層の異なるレベルの .editorconfig ファイルに保存できます。 これらのファイルは通常、VCS に配置され、そこで定義された設定がプロジェクトチーム間で共有されます。
JetBrains Rider では、EditorConfig を使用して、JetBrains Rider の 設定 ダイアログで利用可能な構文スタイル環境設定を定義できます。 サポートされている EditorConfig プロパティの名前と説明は、 EditorConfig リファレンスにあります。
.editorconfig ファイルで定義された構文スタイルプロパティは、この .editorconfig ファイルが適用されるスコープ内で、JetBrains Rider 設定で定義された同じプロパティをオーバーライドすることに注意することが重要です。
EditorConfig を使用して中括弧のスタイルの設定を構成する
目的の .editorconfig ファイルを開きます。
必要な 括弧スタイルのプロパティをファイルに追加します。 例えば：
braces_for_ifelse = required_for_multiline