带有 ref/out 参数的方法的异步版本的元组与自定义结构

Question

考虑使用具有 out 或 ref 参数的方法的 C# API，例如：

Person FindPerson(string name, out int searchTime);

我们不要注意 out 和 ref 参数通常是一种设计味道，假设这是一个遗留 API，我们无法更改其现有方法的签名。但我们需要扩展 API 以支持异步执行（Windows Phone、WinRT 应用程序）。这是一个无法编译的实现：

Task<Person> FindPersonAsync(string name, out int searchTime)
{
    return Task.Factory.StartNew(() => this.FindPersonAsync(name, out searchTime));
}

由于 out 参数，此实现无法编译。所以我们必须更改 API 签名。一种方法是将结果从 task-of-person 更改为 task-of-tuple-of-person-and-int，即委托实现将返回 Person 和 int 的元组。第二种选择是定义一个自定义结构。

元组优势：使用元组提供了一种非常正式的方法，可用于轻松定义任何 API 的异步版本。可预测的实现（未定义新名称）。使用自定义结构需要为每个此类案例发明​​新的类型和成员。

自定义结构的优势：使用元组的客户端代码需要使用 Item1 和 Item2 名称来引用元组元素。这很模糊。

我没有找到任何建议，暂时决定使用元组。但我想知道在使用异步支持扩展 API 时是否有处理此类方法的推荐做法。

Answer 1

我不知道关于此事的任何最佳做法或建议；但根据我自己的经验，Tuple 使代码变得丑陋且毫无意义 - 当您看到 Item1 时，这意味着什么？

我总是使用自定义类并遵守一些约定：

• 自定义类的名称以Result 结尾，如FindPersonResult。
• 将类设计为 POCO，在构造函数中没有特殊逻辑。当您使用系统的其他部分和其他 API（尤其是在序列化和反序列化时）时，这可以防止任何意外。
• 始终将集合字段/属性（数组、列表等）的初始值设置为非空值。这在很多情况下也有帮助。

请记住，这些只是我在这件事上的个人经历，对我来说非常有效。