Durable Task Roslyn Analyzer for C# オーケストレーション

dotnet add package Microsoft.DurableTask.Analyzers

どのように機能するのか

アナライザーは、Visual Studio、Visual Studio Code (C# Dev Kit 拡張機能を使用)、およびコマンド ラインの dotnet build 中に自動的に実行されます。 オーケストレーター コードが検査され、IDE のエラー一覧とビルド出力に警告またはエラーとして診断が報告されます。

開いているファイルを分析するために IDE 構成は必要ありません。 NuGet パッケージがプロジェクトに存在するとすぐにアナライザーがアクティブになります。

複数のルールについて、アナライザーは Visual Studio と VS Code で自動コード修正 (クイック アクション) も提供します。 たとえば、 DateTime.Now を 1 回のクリックで context.CurrentUtcDateTime に置き換えることができます。

アナライザー ルール

次のセクションでは、Durable Task Roslyn Analyzer に付属するアナライザー ルールをカテゴリ別にグループ化して一覧表示します。

オーケストレーション規則

これらの規則では、オーケストレーション メソッド内で非決定論的または安全でない API の使用を検出することで、 オーケストレーター コードの制約 が適用されます。

アクティビティ ルール

これらの規則では、アクティビティ呼び出しとサブオーケストレーション呼び出しで型の不一致と未解決の名前がチェックされます。

詳細については、GitHubのanalyzer のリリース ノートを参照してください。

Roslyn Analyzer の警告を抑制する

プロジェクト、ファイル、または行レベルでアナライザー診断を抑制できます。

.editorconfig を使用して抑制する

.editorconfig ファイルにエントリを追加して、ルールの重大度を変更するか、完全に無効にします。

[*.cs]
dotnet_diagnostic.DURABLE0001.severity = none

有効な重大度の値は、 error、 warning、 suggestion、 silent、および noneです。

#pragma でインライン抑制

#pragma warning disableを使用して、コードのセクションで特定の警告を抑制します。

#pragma warning disable DURABLE0001
var now = DateTime.UtcNow;
#pragma warning restore DURABLE0001

プロジェクト レベルで抑制する

<NoWarn>エントリを.csproj ファイルに追加して、プロジェクト全体のルールを抑制します。

<PropertyGroup>
  <NoWarn>$(NoWarn);DURABLE0001</NoWarn>
</PropertyGroup>

次のステップ