dotnet/AspNetCore.Docs

Support F# `Async<'T>` as an awaitable type in minimal APIs

Open

#31,140 建立於 2023年11月27日

在 GitHub 查看
 (1 留言) (0 反應) (0 負責人)C# (13,093 star) (24,791 fork)batch import
9.0:bomb: vanQUESTHelp wantedPri1code help wantedseQUESTered

描述

I'm opening this as a placeholder to ensure that the changes from https://github.com/dotnet/aspnetcore/pull/46898 make it into the release notes for 9.0. See also: https://github.com/dotnet/aspnetcore/issues/46773.

I see that 8.0 had #28596, so this issue should be linked to the equivalent for 9.0, if there ends up being one.

Additions

  • Support F# Async<'T> as an awaitable type in minimal APIs endpoints.

Changes

  • New runtime coercions: unit ⇝ void, when unit is the generic type argument of a generic awaitable type. These coercions apply both to minimal APIs endpoints as well as to controller action methods.

    • Task<unit> → Task
    • ValueTask<unit> → ValueTask
    • Async<unit> → Task

    With default serialization settings, endpoints with the return types Task<unit> or ValueTask<unit>, whose response body was formerly the JSON token null, will now return an empty response body instead.

EDIT by @Rick-Anderson to add the following metadata

Page URL

https://learn.microsoft.com/en-us/aspnet/core/fundamentals/minimal-apis?view=aspnetcore-9.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/minimal-apis.md

Document ID

b09824ab-b051-75a1-13b7-b0e281cc46e0

Article author

Rick-Anderson

Associated WorkItem - 186857

貢獻者指南

技術棧
csharp
領域
documentationapi
議題類型
documentation
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
3
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 hours
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
stale
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
mostly clear
前置要求
Familiarity with ASP.NET Core minimal APIsBasic knowledge of F#Understanding of release notes structure
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
60
研究方向
Review the linked PR (dotnet/aspnetcore#46898) and issue #46773 to understand the changes. Locate the release notes file for ASP.NET Core 9.0 in the docs repository. Add an entry documenting that F# Async<'T> is now supported as an awaitable type in minimal APIs, including the new runtime coercions from unit to void. Ensure the entry matches the existing style and format of release notes.