System.Data.Common.DbDataReader.ReadAsync 中的异步是什么？

Question

我正在查看MS reference 的 DbDataReader（也是 DbCommand）的代码，但无法弄清楚 ReadAsync() 方法中的异步是什么。

    virtual public Task<bool> ReadAsync(CancellationToken cancellationToken) {
        if (cancellationToken.IsCancellationRequested) {
            return ADP.CreatedTaskWithCancellation<bool>();
        }
        else {
            try {
                return Read() ? ADP.TrueTask : ADP.FalseTask;
            }
            catch (Exception e) {
                return ADP.CreatedTaskWithException<bool>(e);
            }
        }
    }

ReadAsync 方法只是调用 Read 方法并返回一个完整的任务。 这不是和直接调用Read一样阻塞调用线程吗？

我在 DbCommand ExecuteReaderAsync 和其他方法中注意到了相同的模式。他们只是调用同步版本并返回已完成的任务。

我在这里错过了什么？

更新：我没有错过任何东西，正如@PeterBons 很好地解释的那样（也在the documentation 中）。我仍然不喜欢它，但这是我的问题。

Answer 1

您正在查看抽象类中的虚拟方法。如果您希望（未来）实现能够做一些真正的异步工作，您将必须定义一个允许这样做的方法签名。所以它应该返回一个Task 或Task<T>。请记住，仅使用 Task 不会使任何事情异步，而是使其可等待。

在此示例虚拟方法中使用 Task<bool> 返回类型是为了方便派生自 DbDataReader 的其他类在其 ReadAsync 实现中提供真正的异步行为。

例如，真正的异步实现可以做类似的事情

class TrueAsyncReader : DbDataReader
{
    ...

    public override async Task<bool> ReadAsync(CancellationToken cancellationToken) 
    {
        ...

        return await ReadFromDbAsync();
    }
}

如您所见，您现在可以拥有异步和非异步实现，而无需更改方法签名。

因为您可以轻松地从异步方法调用同步代码，所以这是要走的路。从同步方法调用异步代码是不可能的。

对于需要返回任务的非异步实现，您可以返回类似Task.FromResult<T> 或Task.CompletedTask 的内容。这不会阻塞。

另见await Task.CompletedTask for what?

总结一下：默认实现不做任何异步操作，但派生类可以无需更改方法签名。