C# Xml Documentation and Object Browser

[Guest]

I am looking for an example using a summary element to have both a see and
seealso tag within the summary to get them to show up as links in the Object
Browser.

The following is what I am using and it doesn't work, can someone please help?
<pre>
namespace MyNamespace
{
/// <summary>
/// Summary description for DocExample.
/// </summary>
public class DocExample
{
/// <summary>
/// here is my description of MyMethod,
/// Trying the see tag to DoSomething: <see cref="DoSomething"/> - doesn't
work.
/// Trying the see tag to DoSomething with wrapping text: <see
cref="DoSomething">Some text</see> - doesn't work.
/// Trying the see tag to DoSomething using class: <see
cref="DocExample.DoSomething">Some text</see> - doesn't work.
/// Trying the see tag to DoSomething using namespace,class: <see
cref="MyNamespace.DocExample.DoSomething">Some text</see> - doesn't work.
/// </summary>
public void MyMethod()
{
}

/// <summary>
/// the method does something as well.
/// </summary>
private void DoSomething()
{
}
}
}
</pre>

None of the above examples work to display as expected in the Object browser.

Thanks in advance.

 

[Dave]

Object Browser in VS.NET 2003 does not display links.

If you want to use the <see> link it is only for HTML or compiled HTML help documentation.

Tools --> Build Comment Web Pages...

or, you can use a third party utility such as NDOC.

Just a note: In my experience intellisense suggests to write <seealso> tags within the <summary> tag, although that doesn't seem to
work properly when the help files are compiled. Instead, place all <seealso> tags outside of the summary as a standalone tag.
<see>, however, works fine within the <summary> tag (and any other tag for that matter).

GL

 

[Guest]

Thanks, you have provided the answer I thought was true but hadn't seen it
anywhere.