CA2247:TaskCompletionSource コンストラクターに渡された引数は、TaskContinuationOptions 列挙型ではなく、TaskCreationOptions 列挙型にする必要があります

  • [アーティクル]
プロパティ 値
ルール ID CA2247
Title TaskCompletionSource コンストラクターに渡された引数は、TaskContinuationOptions 列挙型ではなく、TaskCreationOptions 列挙型にする必要があります
[カテゴリ] 使用方法
修正が中断ありか中断なしか なし
.NET 8 では既定で有効 警告として

原因

System.Threading.Tasks.TaskCreationOptions 列挙値ではなく System.Threading.Tasks.TaskContinuationOptions 列挙値で System.Threading.Tasks.TaskCompletionSource を構築しています。 System.Object.ReferenceEquals メソッドを使用して 1 つまたは複数の値の型の等価性をテストしています。

規則の説明

TaskCompletionSource 型には、System.Threading.Tasks.TaskCreationOptions 列挙値を受け入れるコンストラクターと、Object を受け入れる別のコンストラクターがあります。 System.Threading.Tasks.TaskCreationOptions 列挙値ではなく System.Threading.Tasks.TaskContinuationOptions 列挙値を誤って渡すと、Object ベースのコンストラクターが呼び出されます。このコンストラクターで、コンパイルと実行が行われますが、意図される動作がありません。

違反の修正方法

違反を修正するには、System.Threading.Tasks.TaskContinuationOptions 列挙値を対応する System.Threading.Tasks.TaskCreationOptions 列挙値に置き換えます。

    // Violation
    var tcs = new TaskCompletionSource<int>(TaskContinuationOptions.RunContinuationsAsynchronously);

    // Fixed
    var tcs = new TaskCompletionSource<int>(TaskCreationOptions.RunContinuationsAsynchronously);

どのようなときに警告を抑制するか

この規則に違反すると、ほぼ常に、コードが開発者の意図したとおりに動作しないといった、呼び出し元のコードのバグが強調され、TaskCompletionSource は指定されたオプション効果的に無視します。 警告を抑制しても安全なのは、開発者がボックス化された System.Threading.Tasks.TaskContinuationOptions をオブジェクト状態引数として TaskCompletionSource に渡すことを実際に意図していた場合のみです

警告を抑制する

単一の違反を抑制するだけの場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則をもう一度有効にします。

#pragma warning disable CA2247
// The code that's violating the rule is on this line.
#pragma warning restore CA2247

ファイル、フォルダー、またはプロジェクトのルールを無効にするには、構成ファイルでその重要度を none に設定します。

[*.{cs,vb}]
dotnet_diagnostic.CA2247.severity = none

規則のこのカテゴリ全体を無効にするには、構成ファイルでカテゴリの重要度を none に設定します。

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Usage.severity = none

詳細については、「コード分析の警告を抑制する方法」を参照してください。

関連項目