XML Documentation in .NET 2.0 and <see...> links to overloaded methods

  • Thread starter Thread starter =?ISO-8859-1?Q?Lasse_V=E5gs=E6ther_Karlsen?=
  • Start date Start date
?

=?ISO-8859-1?Q?Lasse_V=E5gs=E6ther_Karlsen?=

If I got the following three methods:

/// <summary>
/// Tests the string.
/// </summary>
/// <param name="s">
/// The string to test.
/// </param>
public void Test(String s)
{
}

/// <summary>
/// Tests the integer.
/// </summary>
/// <param name="i">
/// The integer to test.
/// </param>
public void Test(Int32 i)
{
}

/// <summary>
/// Performs a simple test.
/// </summary>
/// <remarks>
/// Also, see <see cref="Test"/> for more information. ----------- here!
/// </remarks>
public void Test2()
{
}

and then compiles this I get:

D:\Dev\VS.NET\DocumentationTest1\DocumentationTest1\GenericClass1.cs(59,34):
warning CS0419: Ambiguous reference in cref attribute: 'Test'. Assuming
'DocumentationTest1.GenericClass1.Test(string)', but could have also
matched other overloads including
'DocumentationTest1.GenericClass1.Test(int)'.

Is there a way to make a link that refers to the overloaded method list?
Using NDoc I can easily output such a page that contains links to the
specific versionf of the overload method.
 
Is there a way to make a link that refers to the overloaded method list?

You already found it. The link works fine, it's just that the
compiler warning is stupid. Add compiler warning 0419 to your list of
ignored warnings (in the project settings).
 
Back
Top