TL; DR :

“어떻게 참조 FancyClass<T>합니까?”

   /// <see cref="FancyClass{T}"/>

“어떻게 FancyClass<T>.FancyMethod<K>(T value)?”

   /// <see cref="FancyClass{T}.FancyMethod{K}(T)"/>

“어떻게 참조 할 수 FancyClass<string>있습니까?”

   /// <see cref="SomeType.SomeMethod(FancyClass{string})"/>
   /// <see cref="FancyClass{T}"/> whose generic type argument is <see cref="string"/>

만약 동안 수 그의 서명을 포함하는 방법을 참조하는 FancyClass<string>(즉, 파라미터 입력 등)를 사용하면 없는 그러한 직접 범용 형 폐쇄 참조. 두 번째 예는 이러한 제한을 해결합니다. (이것은 정적 System.String.Concat(IEnumerable<string>)메소드 에 대한 MSDN 참조 페이지 에서 볼 수 있습니다 ). :

XML 문서 주석 cref규칙 :

• 일반 유형 매개 변수 목록을{}<> 꺾쇠 괄호 대신 중괄호로 묶습니다. 후자로 탈출에서이 예비 부품을 <하고 >– 기억은, 문서 주석은 XML입니다!

• 접두어 (예 :T: 유형, M:메소드, P:특성, F:필드)를 포함하면 컴파일러는 참조의 유효성 검증을 수행하지 않고 cref속성 값을 문서 XML 출력으로 바로 복사합니다 . 따라서 이러한 파일에 적용되는 특수한 “ID 문자열”구문 을 사용해야합니다. 항상 정규화 된 식별자를 사용하고 백틱을 사용하여 일반 유형 매개 변수 ( `n유형, ``n메소드)를 참조하십시오.

• 접두어를 생략하면 일반 언어 이름 지정 규칙이 적용됩니다. using명령문 이있는 네임 스페이스를 삭제 하고 int대신 언어 유형 키워드를 사용할 수 있습니다 System.Int32. 또한 컴파일러는 참조가 올바른지 확인합니다.

XML 문서 주석 cref치트 시트 :

namespace X
{
    using System;

    /// <see cref="I1"/>  (or <see cref="X.I1"/> from outside X)
    /// <see cref="T:X.I1"/>
    interface I1
    {
        /// <see cref="I1.M1(int)"/>  (or <see cref="M1(int)"/> from inside I1)
        /// <see cref="M:X.I1.M1(System.Int32)"/>
        void M1(int p);

        /// <see cref="I1.M2{U}(U)"/>
        /// <see cref="M:X.I1.M2``1(``0)"/>
        void M2<U>(U p);

        /// <see cref="I1.M3(Action{string})"/>
        /// <see cref="M:X.I1.M3(System.Action{System.String})"/>
        void M3(Action<string> p);
    }

    /// <see cref="I2{T}"/>
    /// <see cref="T:X.I2`1"/>
    interface I2<T>
    {
        /// <see cref="I2{T}.M1(int)"/>
        /// <see cref="M:X.I2`1.M1(System.Int32)"/>
        void M1(int p);

        /// <see cref="I2{T}.M2(T)"/>
        /// <see cref="M:X.I2`1.M2(`0)"/>
        void M2(T p);

        /// <see cref="I2{T}.M3{U}(U)"/>
        /// <see cref="M:X.I2`1.M3``1(``0)"/>
        void M3<U>(U p);
    }
}

답변

namespace Test
{
    public class FancyClass<A, B>
    {
        public void FancyMethod<C, D, E>(A a, B b, C c, D d, E e) { }
    }
}

namespace Test
{
    public class FancyClass<T>
    {
        ///
        public string FancyMethod<K>(T value) { return "something fancy"; }
    }

    public class Test
    {
        public static void Main(string[] args) { }
    }
}

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Test</name>
    </assembly>
    <members>
        <member name="M:Test.FancyClass`1.FancyMethod``1(`0)">

        </member>
    </members>
</doc>

/// <see cref="T:FancyClass`1{T}"/> for more information.

/// <see cref="M:FancyClass`1{T}.FancyMethod`1{K}(T)"/> for more information.

/// Here we discuss the use of <typeparamref name="TYourExcellentType"/>.
/// <typeparam name="TYourExcellentType">Your exellent documentation</typeparam>

/// <see cref="FancyClass&lt;T>.FancyMethod&lt;K>(T)"/> for more information.