2009-08-18 3 views
19

이 두 가지 방법이 있다면C#, XmlDoc : 메서드 오버로드를 참조하는 방법

public Foo Get(string bar) { ... } 
public Foo Get(int bar) { ... } 

그리고 다른 방법으로이 xml 문서를 작성하십시오.

/// <summary> 
/// Has a close relation to the <see cref="Get"/> methods. 
/// </summary> 

Get에서 파란 구불 구불 한 모호한 참조입니다. 'Get '. 그것은 사실이지만, 나는 그것을 둘 다 참조하기를 원한다. 이 작업을 수행하는 올바른 방법은 무엇입니까? 아니면 단일 메서드 과부하 만 참조해야합니까?

+0

[C#의 태그에서 메소드 오버플로를 만드는 방법?] (https://stackoverflow.com/questions/419702/how-to-make-a-cref-to-method- overloads-in-a-seealso-tag-in-c) – binki

답변

17

당신은 전체 typenames을해야 할 수도 있지만, 인텔리 즉시 당신이 먼저 브래킷을 넣어 도움이 될 것입니다

/// Has a close relation to the <see cref="Get(string)"/> 
/// and <see cref="Get(int)" /> methods. 

를 사용해보십시오. 도움이

희망,

+4

흠 ... 과부하가 많은 경우 성가 시게 될 수도 있습니다 ... – Svish

+1

실로! 그러나 과부하가 많으면 작업에 리펙터가 있음을 알리는 냄새가 날 수 있습니다. 친절, 댄 –

+2

나는 OP가 원래 원했던 것을 할 수있는 방법이 있기를 정말로 바란다. 이 방법은 더 좋은 방법이 없을 때 실용적이지만, 인수 목록은 실제 발언과 관련이없는 _ 구현 세부 사항이라는 의미에서 부주의합니다. 나중에 세 번째 과부하가 추가되고이 발언이 잊혀지면 사실은 실제로 그렇게했을 때 새로운 과부하에 발언이 적용되지 않는다고 잘못 암시 할 수 있습니다. (나는 더 가까운 접근법을 보았지만 불행히도 그것을 기억할 수 없다고 생각한다.) – Kevin

2

여기 업데이트입니다 이 오래된 질문에 대답하십시오. 거기에 문서가 많지 않기 때문에 이것이 언제 유효하게되었는지 확신 할 수 없습니다. cref 속성을 "o:..."과 같이 접두어로 붙이면 "o:myMethod()"과 같이 오버로드 섹션에 연결되며 해당 메서드의 모든 오버로드를 처리합니다. 다니엘 엘리엇의 대답의 예를 사용하여 :

/// Has a close relation to the <see cref="o:Get()"/> methods. 

이 또한 모호한 참조에 대한 인텔리/ReSharper에서에서 경고를 제거합니다.

관련 문제