问题
Is there a tag for a file reference in a xml code comment? The file is a sql script file. Just wondering if there is a better way than something like this
///<summary>
///please have a look at c:\code\project1\sql\file1.sql
///</summary>
回答1:
You could use a file URI, this makes it clickable in visual studio:
file:///c:/code/project1/sql/file1.sql
回答2:
You can mix in elements from other namespaces, including xhtml, so
///<summary>
///please have a look at <a href="file:///c:/code/project1/sql/file1.sql">file:///c:/code/project1/sql/file1.sql</a>.
///</summary>
Is allowed, though whether it's made use of well or not depends on what you use to turn the XML into something more readable. Tooltip-use at least in my IDE ignores the tag and displays the text inside (which is what I'd want in a tool-tip).
Of course, it's not much use on a machine that doesn't have the correct c:\code\project1\sql\file1.sql
回答3:
The most commonly used tags are listed at http://msdn.microsoft.com/en-us/library/5ast78ax(v=vs.71).aspx. It also mentions that it will process "any tag that is valid XML" so you aren't limited to these.
回答4:
There is such a things like special tag for file reference in XML. It is meta language without such limitations.
来源：https://stackoverflow.com/questions/5403932/c-sharp-xml-code-comment-for-file-reference