如何标记在下一版本中已过时的方法？

Question

是否有类似Obsolete或 的属性Deprecated指示某个方法在下一版本的 C# API 中已过时或已弃用？否则，是否有一个标准来表明这一点，例如将其添加到方法文档的注释中？

Answer 1

您应该使用Obsolete注释将该方法标记为已过时。有关详细信息，请参阅ObsoleteAttribute。

[Obsolete("Your warning message")]
public void MyMethod()
{
    // Method body
}

如果您想抛出错误而不是警告，可以将第二个参数error（布尔值）设置为true。

[Obsolete("Your error message", true)]
public void MyMethod()
{
    // Method body
}