應該返回Task的API中的方法是否以Task或Async結尾

Question

如果API具有同步方法T DoSomething<T>(); ，如果返回Task<T> ，相應的異步方法的命名約定是什么？

Task<T> DoSomethingTask<T>();    

要么

Task<T> DoSomethingAsync<T>();

或者是其他東西？

Answer 1

如果您正在討論async或await方法，那么從MSDN ：

按照慣例，后綴“Async”將添加到由Async或async修飾符修改的方法的名稱中。

...

可以在事件，基類或接口契約建議不同名稱的情況下對約定進行例外處理。 例如，最好不重命名常用事件處理程序的名稱，例如button1_Click。

Answer 2

從我在C＃5 / .NET 4.5中看到的，首選名稱是DoSomethingTaskAsync或DoSomethingAsync

例如，.NET 4.5中的WebClient類具有類似DownloadFileTaskAsync方法，因為它已經有一個名為DownloadFileAsync的方法，所以我假設在Async使用TaskAsync是為了保持向后兼容性。