问题描述
命名空间没有< summary>文件(是吗?),我认为它是好的。/ b $ b很高兴拥有它。例如,
///< summary>
///包含数学函数的类。
///< ; / summary>
名称空间BillyBob.Math {
...
}
现在如果您有多个< summary>使用命名空间编译,例如
有两个类文件,每个文件都有不同的< summary>对于其他相同的命名空间,然后消费者可以循环浏览
不同的摘要描述......它应该是一系列描述。
我想可能会有点混乱,但它比
所有的描述更好。
有时人们在最奇怪的名字空间中提供东西...
Jon
Namespaces don''t have <summary> documentation (do they?), and I think it
would be nice to have it. For instance,
/// <summary>
/// Classes containing math functions.
/// </summary>
namespace BillyBob.Math {
...
}
Now if you had more than one <summary> compiled with a namespace, such as
having two class files each with a different <summary> for its otherwise
identical namespace, then the consumer could be able to cycle through the
different summary descriptions... it should be an array of descriptions.
Might be a little messy I suppose, but it''s better than no descriptions at
all.
Sometimes people deliver things in the strangest namespaces ...
Jon
推荐答案
同意。它们不存在的标准借口是,
名称空间声明通常出现在许多不同的文件中,因此编译器可能会被多个摘要标记混淆。
就个人而言,我认为通过简单地获取找到的
最后一个摘要标记来解决这个问题很简单,并且在发出
警告。程序员只负责使用一个标签。
-
同意。它们不存在的标准借口是,
名称空间声明通常出现在许多不同的文件中,因此编译器可能会被多个摘要标记混淆。
Agreed. The standard excuse why they don''t exist yet is that a
namespace declaration typically appears in many different files, so
the compiler might get confused by multiple summary tags.
我读过课可以分布在C#2的多个文件中 -
不会导致完全相同的混乱吗?
Niki
I''ve read that classes could be spread over multiple files in C# 2 -
wouldn''t that cause exactly the same confusion?
Niki
是的,它会的。我不知道这个案例的建议解决方案
是 - 也许在主类文件之间存在区别。和
延续类文件,只有主文件可以有注释?
-
这篇关于想要使用C#2.0:命名空间文档的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持!