5

코드 : 잘 모르겠어요,XML 설명 - 명시 적으로 구현 된 인터페이스를 어떻게 적절하게 설명합니까?

<seealso cref="IFoo.Bar()"/> //Explicitly implemented interface method 
<seealso cref="Bar()"/>  //Standard method 

하지만 :

public interface IFoo 
{ 
    void Bar(); 
} 

public class FooClass : IFoo 
{ 
    /// <summary> ... </summary> 
    /// <seealso cref="?"/> //How do you reference the IFoo.Bar() method 
    public void Bar() { } 

    /// <summary> ... </summary> 
    /// <seealso cref="?"/> //How do you reference the standard Bar() method 
    void IFoo.Bar() { } 
} 

내 생각이다. ECMA 가이드는 구별하는 데 도움이되지 않았으므로 추측이 정확하다는 확신을 찾고 있습니다.

답변

1

Sandcastle Help File Builder를 사용한 빠른 테스트 결과, 생성 된 문서에서 <seealso cref="IFoo.Bar()"/> 링크가 인터페이스의 메서드를 가리키고 <seealso cref="Bar()"/>이 클래스의 메서드를 가리킨다는 것이 밝혀졌습니다. 명시 적으로 구현 된 메서드에 대한 설명서는 인터페이스에서 상속되므로 실제로 어쨌든 인터페이스 메서드를 가리켜 야합니다.

편집 : ReSharper도 <seealso cref="FooClass.IFoo.Bar()"/>으로 불평하고 <seealso cref="IFoo.Bar()"/>으로 수정되며 명시 적으로 구현 된 인터페이스 메서드가 아니라 인터페이스 메서드를 가리 킵니다.

+0

그건 내가 생각한 것이지만 나는 100 % 확신하지 못했습니다. 그 점을 명확히 해 주셔서 감사합니다. –

+0

반갑습니다. –

+1

XML 주석을 통해 명시 적으로 정의 된 인터페이스 메소드를 참조 할 방법이 없습니까? – MDR