5

Kodu: Emin değilim,XML Yorumlar - Açıkça uygulanmış arayüzleri düzgün bir şekilde nasıl yorumluyorsunuz?

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

ama:

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() { } 
} 

Benim tahminim olduğunu. ECMA rehberi ayırt etmede yardımcı olmadı, bu yüzden tahminimin doğru olduğuna dair güvence sağlamayı düşünüyorum.

cevap

1

Sandcastle Yardım Dosyası Oluşturucusu ile yapılan hızlı bir test, oluşturulan belgede <seealso cref="IFoo.Bar()"/> bağlantı noktasının ara yüzdeki yönteme işaret ettiğini ve <seealso cref="Bar()"/> sınıfındaki yönteme işaret ettiğini ortaya çıkardı. Açıkça uygulanan yöntemle ilgili belgeler, arabirimden devralınmıştır, bu nedenle, aslında arabirim yöntemine işaret etmelisiniz.

Düzenleme: ReSharper ayrıca <seealso cref="FooClass.IFoo.Bar()"/> ile ilgili olarak şikayette bulunur ve <seealso cref="IFoo.Bar()"/> olarak düzeltir ve bu, açıkça uygulanan bir arabirim yöntemini işaret eder.

+0

Düşündüğüm buydu, ama% 100 emin değildim. Bunu açıkladığın için teşekkürler. –

+0

Rica ederim. –

+1

Açıkça tanımlanmış arabirim yöntemini xml açıklamalarına referans olarak görmenin bir yolu yok mu? – MDR

İlgili konular