可能な NullReferenceExceptions を検出する

null チェックは、.NET 開発で最も一般的な操作の 1 つです。ReSharper は、潜在的に null になる可能性のあるエンティティを扱う開発者に特別なサポートを提供することによって、null チェックを真剣に受け入れるツールの 1 つです。

ReSharper が行う最初のことは、NullReferenceException が発生する可能性を検出することです。例: 最初に存在するかどうかを確認せずに XML 属性の値にアクセスしようとします。

var xe = XElement.Parse("<test/>");
var attrib = xe.Attribute("a");
var value = attrib.Value;
    

この方法で Value にアクセスすることはあまり安全ではないため、ReSharper は下線を引き、マウスをその場所に移動すると次のポップアップが表示されます。

ReSharper detects possible NullReferenceException

識別子の上にキャレットを置き、Alt+Enter を押すとクイックフィックスが表示され、自動的に変数の null チェックを行うことができます:

ReSharper suggests to automatically do a null check on the variable

ReSharper によって行われる null チェックの大部分は、2 つの方法で機能するコードアノテーションによって実装されます。

まず、ReSharper インストールに含まれている、.NET FCL および NUnit からの大量のシンボルに、外部アノテーション付きの属性でアノテーションを付けました。たとえば、上記の例の Attribute メソッドには、このように CanBeNullAttribute というアノテーションが付けられています。

外部的にアノテーションを付けたメソッドの別の例を次に示します: null パラメーターを持つ Uri を作成しようとすると、次のポップアップメッセージが表示されます。

もちろん、独自のコードでこれらの属性を使用することを妨げるものはありません。これらの属性をプロジェクトに追加するには、いくつかの方法があります。

推奨される方法は、JetBrains.Annotations アセンブリを使用して NuGet パッケージ(英語)をインストールすることです。
実際には、パッケージを入手するために NuGet Web サイトにアクセスする必要はありません。using JetBrains.Annotations; ディレクティブを追加し、対応する Alt+Enter アクションを使用して、パッケージを自動的にフェッチするだけです。
ReSharper インストールディレクトリにある JetBrains.Annotations.dll にプロジェクト参照を追加できます。
デフォルトの JetBrains.Annotations 名前空間またはその他の名前空間を使用して、プロジェクト内の任意の場所に属性宣言を埋め込むこともできます。

これで、独自のメソッドのパラメーターをこれらの属性で飾ることができ、ReSharper がそれらの属性を取得します:

2024 年 9 月 25 日

関連ページ：

コードの問題のクイックフィックス

ReSharper を使用すると、設計時に検出されたほとんどのコード問題を即座に修復できます。ハイライトされたコードの問題でを押して、問題を解決したり最適以下のコードを改善したりするための適切な方法を選択するのと同じくらい簡単です。クイックフィックスの適用：クイックフィックスは、ハイライトされたコードの問題の左側にアクションインジケーターとして視覚的に表示されます。これらのインジケーターは、コードの問題にキャレットを置くと表示されます。次のインジケーターは、簡単な修正を意味します。エラー重大

ソースコードのアノテーション

ReSharper のコードアノテーションの恩恵を受ける最も簡単な方法は、ソースコードのシンボルにアノテーション属性を追加し、ReSharper がソリューションをより正確かつ洞察力で分析できるようにすることです。プロジェクトでコードアノテーションのサポートを有効にする：プロジェクトでアノテーション属性を利用するには、プロジェクトで参照する必要があります。推奨される方法は、アセンブリを使用して NuGet パッケージをインストールすることです。実際には、パッケージを入手するために NuGet W...

インストールガイド

ReSharper は Visual Studio 拡張機能です。Visual Studio 2010, 2012, 2013, 2015, 2017, 2019, 2022,, 2026 をサポートします。インストール後、Visual Studio の拡張メニューに新しい ReSharper エントリが表示されます。ほとんどの ReSharper コマンドはそのメニューで使用できますが、エディター、ソリューションエクスプローラー、その他の Visual Studio ウィンドウに統合されている多く...

ReSharper と TeamCity を使用してビルドでコードの問題を検出する

TeamCity サーバー上のビルドに対して ReSharper のコードインスペクションを実行できることをご存知ですか ? 実際、ずっと前に TeamCity でこの機能のサポートを追加しましたが、この機能は特に ReSharper ユーザーに広く知られていないようです。セットアップ自体は非常にシンプルなので、ここで詳しく説明し、さらに便利な機能を追加します。TeamCity の使用を開始するには、TeamCity のドキュメントを学びましょう。TeamCity での .NET インスペクション...

新しい C# 機能への移行を支援

C# の新しいバージョンが登場すると、最新の構文機能を利用するためにコードを更新したいのは当然のことです。幸運にも、ReSharper はあなたのコードを自動的に更新できます。例として、C# 6.0 の最も優れた機能の 1 つ、条件付きアクセス式を取り上げます。最初に注意することは、ReSharper がエディターで新しい言語機能を使用する可能性をやさしく指摘しているということです。通常どおり、ハイライトされたコードでを押すと、新しい言語機能を使用するのに役立つクイックフィックスが表示されます...