C#「CS0121: The call is ambiguous」が .NET 10 で出る原因と直し方
.NET 10 で出る CS0121: The call is ambiguous は、System.Linq.Async を外すか 7.0.0 に上げれば直る。
.NET 10 が同じ名前の AsyncEnumerable を標準に入れ、Where などの候補が 2 つになった。
公開:
要約
TargetFramework を net10.0 に上げたプロジェクトで、IAsyncEnumerable<T> に Where や ToListAsync を呼ぶ行が CS0121 で止まることがある。
次の出力は、パスと型の引数を省いたものである。
error CS0121: The call is ambiguous between the following methods or properties: 'System.Linq.AsyncEnumerable.Where<TSource>(…) [.../System.Linq.Async.dll]' and 'System.Linq.AsyncEnumerable.Where<TSource>(…) [.../System.Linq.AsyncEnumerable.dll]'.NET 10 は、IAsyncEnumerable<T> 用の LINQ を標準の System.Linq.AsyncEnumerable クラスに入れた(公式の破壊的変更の説明(新しいタブで開く))。
.NET 9 までは、コミュニティの System.Linq.Async パッケージが同じ名前のクラスで提供していた。
両方があると、同じ呼び出しに候補が 2 つ見つかる。
エラー文の 2 つの候補は名前が同じで、角かっこの中の DLL だけが違う。
解決策
1. 直接の参照なら System.Linq.Async を消す
dotnet remove package System.Linq.Async標準の LINQ には SelectAwait が無いので、消した直後は CS1061 で止まる。
公式のとおり、Select に CancellationToken も受け取る非同期のラムダを渡す形に書き換える。
// System.Linq.Async の書き方
var doubled = await Numbers().SelectAwait(async n => { await Task.Yield(); return n * 2; }).ToListAsync();
// .NET 10 の標準の書き方
var doubled = await Numbers().Select(async (int n, CancellationToken ct) => { await Task.Yield(); return n * 2; }).ToListAsync();Where や ToListAsync は名前が同じなので、書き換えずにそのまま通った。
2. 参照を残すなら 7.0.0 に上げる
dotnet add package System.Linq.Async --version 7.0.06.0.3 を 7.0.0 に上げただけで、CS0121 は消えて build が通った。SelectAwait の行には、Select に替えるよう促す非推奨の警告 CS0618 が出た。
net10.0 と古い TargetFramework の両方を対象にするプロジェクトなら、公式は System.Linq.Async の代わりに System.Linq.AsyncEnumerable パッケージを参照するよう書いている。
3. 間接の参照なら ExcludeAssets で外す
<PackageReference Include="System.Linq.Async" Version="6.0.3">
<ExcludeAssets>compile</ExcludeAssets>
</PackageReference>compile を指定すると、自分のコードからは System.Linq.Async が見えなくなる。
依存するパッケージは、実行時に使い続けられる。
6.0.3 にこの指定を付けると CS0121 は出なくなったが、自分のコードで呼んでいた SelectAwait は見えなくなり、CS1061 で止まった。
その呼び出しは 1 の形に書き換える。
どの依存も実行時に要らないと分かっているときだけ、all にして完全に外す。
よくある原因
- System.Linq.Async 6.x を直接参照したまま、TargetFramework を net10.0 に上げた。
.NET SDK 10.0.404 で 6.0.3 を参照すると、WhereとToListAsyncの行がそれぞれ CS0121 になった。 - 別のパッケージが System.Linq.Async に依存していて、間接的に入ってきている。
csproj に System.Linq.Async の行が無くても、公式によると同じあいまいさが起きる。