C# XMLドキュメントコメントの警告CS0419について解説

/// MyClass の説明です。リンク先は <see cref="MyClass.MyMethod"/> です。
public class MyClass
{
    /// <summary>
    /// メソッドの説明です。
    /// </summary>
    public void MyMethod()
    {
    }
}

※ ドキュメント生成ツールでリンクが正しく解決されます。

interface IInterface
{
    /// <summary>
    /// 引数なしの F メソッドです。
    /// </summary>
    void F();
    /// <summary>
    /// 引数ありの F メソッドです。
    /// </summary>
    void F(int value);
}
/// <summary>
/// MyClass の説明です。
/// </summary>
public class MyClass
{
    /// <summary>
    /// <see cref="IInterface.F"/> を参照しているため、どちらの F メソッドか曖昧です。
    /// </summary>
    public static void MyMethod(int value)
    {
        // 実際の処理は省略
    }
    /// <summary>
    /// エントリーポイントです。
    /// </summary>
    public static void Main()
    {
        MyMethod(5);
    }
}

コンパイル時に警告 CS0419 が表示されます。

interface IInterface
{
    /// <summary>
    /// 引数なしの F メソッドです。
    /// </summary>
    void F();
    /// <summary>
    /// 引数ありの F メソッドです。
    /// </summary>
    void F(int number);
}
/// <summary>
/// MyClass の説明です。
/// </summary>
public class MyClass
{
    /// <summary>
    /// <see cref="IInterface.F(int)"/> を指定することで、引数ありのオーバーロードを明示しています。
    /// </summary>
    public static void MyMethod(int number)
    {
        // 実際の処理はここに記述
    }
    /// <summary>
    /// エントリーポイントです。
    /// </summary>
    public static void Main()
    {
        MyMethod(10);
    }
}

警告は表示されず、正しくドキュメントが生成されます。

interface IInterface
{
    /// <summary>
    /// 引数なしの F メソッドです。
    /// </summary>
    void F();
    /// <summary>
    /// 引数ありの F メソッドです。
    /// </summary>
    void F(int number);
}
/// <summary>
/// MyClass の説明です。
/// </summary>
public class MyClass
{
    /// <summary>
    /// <see cref="IInterface.F(int)"/> のように記述することで、対象のオーバーロードを明示しています。
    /// </summary>
    public static void MyMethod(int number)
    {
        // 実際の処理はここに記述
    }
    /// <summary>
    /// エントリーポイントです。
    /// </summary>
    public static void Main()
    {
        MyMethod(20);
    }
}

正しい参照指定により、CS0419 警告は発生しません。

interface IInterface
{
    /// <summary>
    /// 引数なしの F メソッドです。
    /// </summary>
    void F();
    /// <summary>
    /// 引数ありの F メソッドです。
    /// </summary>
    void F(int number);
}
/// <summary>
/// ExampleClass の説明です。<see cref="IInterface.F"/> と記述すると曖昧です。
/// </summary>
public class ExampleClass
{
    public static void Execute(int number)
    {
        // 処理内容は省略されています
    }
    public static void Main()
    {
        Execute(30);
    }
}

上記のコードでは、CS0419 警告が発生します。

interface IInterface
{
    /// <summary>
    /// オーバーロードなしの F メソッドです。
    /// </summary>
    void F();
    /// <summary>
    /// オーバーロードありの F メソッドです。
    /// </summary>
    void F(int value);
}
/// <summary>
/// ExampleClass の説明です。<see cref="IInterface.F(int)"/> を指定して警告を防止しています。
/// </summary>
public class ExampleClass
{
    /// <summary>
    /// 正しい記述例です。
    /// </summary>
    public static void Execute(int value)
    {
        // 実際の処理内容はここに記述
    }
    /// <summary>
    /// エントリーポイントです。
    /// </summary>
    public static void Main()
    {
        Execute(50);
    }
}

正確な `cref` 指定により、CS0419 警告は発生しません。