XML Doc에서 메소드 그룹에 대한 참조를 삽입 할 수 있습니까? 어떻게?

StackOverflow https://stackoverflow.com/questions/1411859

문제

C#에서는 속성, 메소드, 이벤트 등에 대한 문서를 첨부하여 코드를 XML 문서 주석.

특정 방법에 대한 참조를 삽입하는 방법을 알고 있습니다.

<see cref="MethodName(TypeForArg1, TypeForArg2..)"/>

에 대한 참조를 삽입하는 방법이 있습니까? 방법 그룹? 동일한 메소드 이름의 여러 오버로드가있는 곳 ...

나는 시도했다 

<see cref="M:MethodName"/>

.. 그러나 그것은 작동하지 않았습니다.

편집하다: 충돌

도움이 되었습니까?

해결책

분명히 이것을 할 방법이 없습니다.

다른 팁

이것은 적어도 Visual Studio 2012에서 고정 된 것으로 보입니다.

<see cref="MethodName"/>

경고를 생성합니다.

CREF 속성의 모호한 참조 : 'MethodName'. '…'를 가정하지만 '…'를 포함한 다른 과부하와 일치 할 수도 있습니다.

그러나 추가 M: 앞쪽에서 경고를 제거합니다.

<see cref="M:MethodName"/>

이것은 현재 Sandcastle에서 지원됩니다.

메소드 그룹을 참조하려면 다음 구문이 필요합니다.

/// <summary>
/// Reference to a method group with two items:
/// <see cref="O:Full.Declaring.Namespace.TypeName.Foo"/>
/// </summary>
void Foo() { }
void Foo(int x) { }

이 구문은 설명대로 여전히 몇 가지 제한 사항이 있습니다. 이 C# 언어 기능 요청.

  • 구문은 빌드 중에 검증되지 않습니다. 타이핑 중에 발생한 오류는 IF/Sandcastle 도움말 파일 빌더가 주석을 처리 할 때까지보고되지 않습니다.
  • 구문 뿐 동일한 이름의 메소드가 둘 이상인 경우 작동합니다.
  • 이 구문에 대한 구문 강조 표시 또는 편집기 지원이 없습니다.
라이센스 : CC-BY-SA ~와 함께 속성
제휴하지 않습니다 StackOverflow
scroll top