JetBrains Rider 2024.1 ヘルプ

コードの構文スタイル: 組み込み型参照

C# タイプのキーワードと .NET フレームワーク(CLR)のタイプ名は、内蔵 C# タイプのために互換性があります。ビルトインタイプの名前に 1 つまたは別のスタイルを使用することをお望みなら、JetBrains Rider はあなたの好みを維持できます。

静的メンバーアクセス(CLR 型名 - var str = String.Empty; など)と、ローカルメンバー、メンバー、パラメーター(キーワード - void Foo(string str){ } など)に別々のスタイルを維持できます。

JetBrains Rider を使用すると、既存のコードで C# 組み込み型の設定を適用できます。コード補完コード生成機能を使用して新しいコードを作成し、コードテンプレートを適用し、リファクタリングを実行するときに設定が考慮されます。

C# 組み込み型の設定を強制する

JetBrains Rider はすべての組み込み型参照があなたの好みに合っているかどうかをチェックし、それらが準拠していない場合はそのような参照をハイライトし、対応するクイックフィックスまたはスコープの修正を提案します。デフォルトの JetBrains Rider の設定では、C# キーワードが優先されると言われています。

Built-in type usage style quick-fix

設定を変更した場合、JetBrains Rider は .NET フレームワークタイプ名の使用に役立ちます:

Built-in type usage style quick-fix

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

カスタムコードクリーンアッププロファイルを使用して C# 組み込み型参照の設定を適用する

  1. Ctrl+Alt+S を押すか、メニューからファイル | 設定(Windows および Linux)または JetBrains Rider | 環境設定 (macOS) を選択します。

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

  3. 新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って、新しいプロファイルを作成します。新しいプロファイルの選択したプロファイル設定セクションで、組み込み型参照を修正するチェックボックスをオンにします。必要に応じて、このプロファイルで他のコードクリーンアップタスクを有効にすることができます。

  4. 設定ダイアログで保存をクリックして変更を適用し、JetBrains Rider が変更を保存する場所を選択できるようにするか、保存セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「レイヤーベースの設定」を参照してください。

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

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

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

  6. Ctrl+R, C を押すか、メインメニューからコード | 再フォーマットとクリーンアップ…を選択します。

  7. 開いたコードの再フォーマットとクリーンアップダイアログで、新しく作成したプロファイルを選択し、必要に応じて別のスコープを選択します。

  8. OK をクリックします。JetBrains Rider は選択した範囲内であなたの設定を強制します。

コードの再フォーマットとクリーンアップダイアログを開いてプロファイルを選択せずに C# 組み込み型の設定を強制する場合は、作成したプロファイルをサイレントクリーンアップにバインドし、Ctrl+R, G を押して実行できます。設定の適用と他のコードスタイルタスクを組み合わせたカスタムクリーンアッププロファイルを作成することもできます。

C# 組み込み型参照の環境設定を、他のすべてのフォーマットおよび構文スタイルの規則とともに、選択したコードブロック Alt+Enter に適用するには、再フォーマットとクリーンアップ | 構文スタイルを再フォーマットして適用するを選択します。

最近変更して Git にコミットしようとしているコードで、C# 組み込み型の環境設定を適用できます。JetBrains Rider は、コミットする前に、選択したクリーンアッププロファイルを実行します。

Git にコミットする前にコードをクリーンアップする

  1. Ctrl+K を押すか、メインメニューから Git | コミットを選択します。

  2. コミットツールウィンドウで Show Commit Options をクリックし、コミットチェック領域でクリーンアップ ... チェックボックスを選択します。

  3. プロファイルの選択をクリックして、カスタムコードクリーンアッププロファイルを選択します。

  4. コミットまたはコミットとプッシュをクリックします。JetBrains Rider は、コミット用にステージングされたファイルでコードのクリーンアップを実行し、変更をコミットします。

変更をファイルに保存するたびに C# 組み込み型の設定を適用して、編集が常にコードスタイルに準拠するようにすることができます。これは、変更を Ctrl+S または Ctrl+S で明示的に保存した場合にのみ発生し、auto-saving によってトリガーされないことに注意してください。ただし、自動保存されたすべてのファイルは「再フォーマットおよびクリーンアップ」キューに配置され、次の明示的な保存で処理されます。

変更の保存時に C# 組み込みタイプの設定を自動的に適用する

  1. Ctrl+Alt+S を押して設定を開き、ツール | 保存時のアクションを選択します。

  2. コードの再フォーマットとクリーンアップを選択し、カスタムコードクリーンアッププロファイルを選択して、それをファイル全体に適用するか、変更された行のみに適用するかを選択します。

  3. 次に編集を終了してファイルまたはすべてのファイルを保存すると、JetBrains Rider は選択されたプロファイルを使用して影響を受けるファイルをクリーンアップします。

C# 組み込み型を参照するための設定を構成する

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

C# 組み込みタイプの設定を構成する

  1. JetBrains Rider 設定 Ctrl+Alt+Sエディター | コードスタイル | C# ページに移動し、構文スタイルタブを選択します。

  2. ビルトイン型カテゴリの設定を、コーディングのプラクティス / 標準に従って変更します。

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

  4. 設定ダイアログで保存をクリックして変更を適用し、JetBrains Rider が変更を保存する場所を選択できるようにするか、保存セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「レイヤーベースの設定」を参照してください。

C# ビルトイン型の参照の設定をエディターで変更することもできます。この場合、対応する問題がハイライトされます。

エディターから C# 組み込みタイプを参照する設定を変更

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

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

  3. アクションリストでインスペクション " 組み込み型参照を置き換えます ..." | コードスタイルを設定するを選択し、希望の設定を選択します。

    Changing code style preference for referencing C# built-in types
  4. 変更は、スマートセーブロジックを使用して保存されます。

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

関連ページ:

.NET 固有のテンプレート

このセクションには、C#、VB.NET、ASP.NET、Razor、XAML コードの作成に使用できる .NET 固有のコードテンプレートのドキュメントが含まれています。テンプレートの種類、テンプレートスコープ、テンプレート変数、テンプレートマクロ、テンプレートを適用するライブテンプレートを使用してソースコードを作成する、コードフラグメントをテンプレートで囲む、テンプレートからファイルを作成する、テンプレートを作成および編集するライブ / サラウンドテンプレートを作成する、ファイルテンプレートを...

コード生成

JetBrains Rider は、定型コードを生成するさまざまな方法を提供します。例: 宣言されていないコードシンボルを使用し、これらのシンボルを用途に基づいて自動的に生成したり、型メンバーを生成したりすることができます。現在のファイルで設計時コードインスペクションが有効になっている場合、JetBrains Rider は足りないメンバーを検出し、足りないメンバーを実装するために対応するクイックフィックスを提案します。コンテキストアクションとコードテンプレートを使用すると、コードを生成するその...

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

JetBrains Rider は、エディターでコードファイルを開くとすぐに、コードファイルが閉じられるまで分析を開始します。検出されたすべてのコードの問題は、重大度に応じてエディターでハイライトされます。問題のマップは、エディターウィンドウの右側のエラーストライプにも表示されます。ここでは、ファイルのステータスを即座に確認し、マークをクリックして特定のコードの問題に移動できます。デザインタイムインスペクションの機能:デザイン時のインスペクション機能は、Rider エディターの基本機能への主要...

スコープを修正

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

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

設計時コードインスペクションを構成する:デフォルトでは、JetBrains Rider はサポートされている言語に対応するすべてのファイルで設計時コードインスペクションを有効にします。必要に応じて、無効にすることができます。設計時コードインスペクションが有効かどうかにかかわらず、コードインスペクションを特定の範囲でいつでも実行できます。「鉛筆」ウィジェットを使用して、エディターから直接インスペクション設定をすばやく調整するか、設定でより詳細な構成を行うことができます。を押すか、メニューから(W...

レイヤーベースの設定

Rider 設定ダイアログでは、ページアイコンを見て、特定のページに使用されている設定管理メカニズムを確認できます。任意のアイコンでマークされていないページは、ユーザープロファイルに保存されている IDE 設定をホストします。レイヤーベースの設定は ReSharper と互換性があるため、ReSharper を使用している場合、チームメンバーのいずれかがそれを使用している場合、Rider は ReSharper で構成した設定を読み取って適用できます。「ソリューションパーソナル」および「ソリュ...