Visual Studio Summary Gözükmeme Sorunu Nasil Cozulur ?

Eğer aşağıda gözüken summary gözükmeme soruna benzer bir sorunununuz varsa belki bu yazı size yardımcı olabilir.

/// <summary>
/// Buradaki Yazı gözükmüyorrrrr !!!??!?!?!?
/// </summary>
public class ExampleClass
{

}

Summary metinleri arka planda belirli bir xml uzantılı dosyanın içerisine yazılır. Bazen bu "belirli" dosyanın ne olduğu konusunda sizin IDE'ye belirtide bulunmanız gerekir aksi halde nereye yazacağını bilemez ve yazmaz. Veya bu xml dosyasının oluşturulmamış olabilmesi de yaşanabilecek sorunların kaynağı olabilir.

Tavsiyeler :

• XML dosyasının DLL adıyla eşleştiğinden emin olun (ör. myAssembly.dll -> myAssembly.xml)
• Projeniz içerisinde summary için yapılandırılmış bir xml dosyası olup olmadığını kontrol edin.

Bu tavsiyeleri gözden geçirdikten sonra ;

Solution Explorer pencesinde bulunan projenizin(.csproj) tam üstüne sağ tıklayın ardından en altta çıkan "properties" seçeneğine tıklayın.

Karşınıza çıkan pencereden build->output alt başlığına ilerleyin.

Burada karşınıza çıkan Documentation File'ın tikli değilse kutucuğuna tıklayarak aktif hale getirelim.

Ardından projemiz klasörlerinde bulduğumuz summary için yapılandırılmış xml dosyasının konumunu buraya verelim.

Eğer böyle bir dosya yoksa veya bulamadıysanız kendiniz /doc klasörü altına projenizin DLL adıyla eşleşen bir xml dosyası açıp konumunu buraya verin.(/doc klasörü de yoksa, onu da açabilirsiniz. Veya doc yerine farklı bir yere de kaydedebilirsiniz.)

Yaptığınız tüm bu değişiklikleri kaydedip IDE'yi açıp kapatın.

Ben kendi sorunumu böyle çözmüştüm. İşe yaramadıysa kaynakçadaki linklerden araştırmaya devam edebilirsiniz.

KAYNAKÇA :

• stackoverflow.com/questions/32994598/how-to-include-documentation-in-dll-to-show-method-summary-in-unity3d
• stackoverflow.com/questions/1632942/how-do-you-get-xml-comments-to-appear-in-a-different-project-dll