是否可以将程序集标记为已弃用？

Question

当用户编译引用我们计划删除的程序集的代码时，我想生成一条警告消息。此程序集的内容已与另一个程序集合并，我想鼓励用户停止引用旧程序集。

不幸的是，ObsoleteAttribute 似乎对程序集无效。在构建引用程序集的项目时，是否有任何其他方式导致编译器警告？

谢谢。

编辑：为澄清起见，以下是合并前后程序集的样子

合并前：

Assembly1:
namespace A.B.C {
    class C1
    ...
}

Assembly2:
namespace A.B.D {
    class D1
    ...
}

合并后：

Assembly1:
(empty)

Assembly2:
namespace A.B.C {
    class C1
    ...
}

namespace A.B.D {
    class D1
    ...
}

在合并之前，用户同时引用了 Assembly1 和 Assembly2。合并后，他们只需要引用 Assembly2，但我宁愿警告说不再需要 Assembly1，而不是通过立即删除 Assembly1 来破坏他们的构建。

听起来我应该使用类型转发器来确保已经针对这些程序集构建的程序继续工作而无需重新编译，但我不想将存根类留在 Assembly1 中只是为了将程序集标记为过时.

Answer 1

将类型从一个程序集移动到另一个正确的做法是使用type forwarder，而不是将旧的程序集类标记为过时。

见："CLR Hoser - The Wonders of Whidbey Factoring Features – Part I: Type Forwarders" by Richard Lander (2005)

Answer 2

将旧程序集中的每个类标记为不可用。

这对我有用：

[Obsolete("Deprecated.  Use 'Substitute' class in 'NewAssembly' instead.")]
public class OutdatedClass : IDisposable, IXmlSerializable
{ 
    //code...
}

在尝试编译时，我收到了大量关于使用该类的警告。

您可以通过将 True 作为第二个参数传递给属性来使其引用程序集成为编译错误。

[Obsolete("Deprecated.  Use 'Substitute' class in 'NewAssembly' instead.", true)]

public class OutdatedClass : IDisposable, IXmlSerializable
{ 
    //code...
}

我刚刚测试过，它也有效（即 - 编译失败）

Answer 3

我在 MSDN 上没有看到任何具体内容。但是，您可以创建自己的程序集属性，但前提是您认为它很重要。再说一次，这样做并不能阻止某人使用它，而且我不确定你怎么能让别人知道它已被弃用。

老实说，我想我会将[Obsolete] 放在可公开访问的课程上。

根据我在 @Eric 的帖子中阅读的内容以及他提供的链接以及 WS 的评论，请使用 [TypeForwardedTo]。