跳至主要內容

第 11 章:非同步 API 設計指南

本章大綱

  • 命名與簽名:Async 後綴與取消慣例
    • 公開的非同步操作通常應加上 Async 後綴
    • 支援取消時,提供接受 CancellationToken 的多載並一路向下傳遞
    • 不要把公開 API 設計成 async void
  • 同步與非同步 API 的取捨
    • 規則一:絕對不要包裝非同步來假裝同步
    • 規則二:絕對不要包裝同步來假裝非同步
    • 結論:優先提供它真正需要的版本
  • 例外、取消與逾時語意
    • 例外的拋出時機
    • 不要把例外當成一般控制流程
    • 逾時與取消的區別
  • ValueTask 的適用時機與限制
    • ValueTask 的優勢
    • ValueTask 的限制
  • 函式庫開發者的 ConfigureAwait(false) 準則
  • IAsyncDisposable 與自有資源的生命週期
  • 結語

本章未開放免費試讀,請購買本書以立即閱讀完整版。

購買本書