CA2247:TaskCompletionSource コンストラクターに渡された引数は、TaskContinuationOptions 列挙型ではなく、TaskCreationOptions 列挙型にする必要があります
プロパティ | 値 |
---|---|
ルール ID | CA2247 |
Title | TaskCompletionSource コンストラクターに渡された引数は、TaskContinuationOptions 列挙型ではなく、TaskCreationOptions 列挙型にする必要があります |
[カテゴリ] | 使用方法 |
修正が中断ありか中断なしか | なし |
.NET 9 では既定で有効 | 警告として |
原因
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
詳細については、「コード分析の警告を抑制する方法」を参照してください。
関連項目
.NET