Soru Intellisense için yorumlara satır sonları ekleniyor [duplicate]


Bu sorunun zaten bir cevabı var:

Çizgi kırılmalarının Intellisense belgelerine yansıtılması için bir özet yorumuna nasıl satır sonu ekleyeceğini bilen var mı?

Açıklığa kavuşturmak, kod dökümanlarını almak.

/// <summary>
/// Some text documentation
///  - a line break - 
/// Some more documentation
/// </summary>
public void SomeMethod() { }

Yani bu yöntemi kullanırken Intellisense, bu şekilde biçimlendirilmiş yöntem için bir özet sunar:

Bazı metin belgeleri

Daha fazla dokümantasyon

(Not - 'para' etiketi boş satır sonları oluşturmaz - denedim!)


76
2018-01-21 21:58


Menşei


Bir "para", yarı cevaptır (aslında ikiye bölünür), satırın başlangıcı ve sonu kesilir. Bir satırın başlangıcını ve özetini sonlandırmak için aşağıdaki "<para> </ para>" ifadesini ekleyin (karakterin atlanması - aslında görünmeyen ve sıfır alan). - SoLaR


Cevaplar:


Bunu kullanmayı dene.

/// <summary>
/// <para>Paragraph 1.</para>
/// <para>Paragraph 2.</para>
/// </summary>

Ama gerçek boş bir çizginiz olabileceğini sanmıyorum. Boş para etiketi göz ardı edilir.


67
2018-01-21 22:01



Sadece bir ara vermek istediğini sanıyordum. Asıl boş bir çizginiz olabileceğini sanmıyorum. - Brian Kim
MS, örneğin yöntemlerdeki istisnalarla bunu nasıl yapıyor? - flesh
İstisnalar XML'de ayrı etiketlerdir. Özette boş bir satır değil, sadece belgelerin farklı bölümlerini oluşturuyor - bdukes
Biraz daha hoş bir versiyon: /// <summary> /// <para> 1. Paragraf. </ Para> /// <para> 2. Paragraf. </ Para> /// </ summary> - Peter Huber
Çirkin biçimlendirme için özür dilerim, ama aptal stackoverflow 5 dakika sonra bir yorumu değiştirmeye izin vermiyor ve herhangi bir iyi biçimlendirmeyi yine de engelliyor. Uygun örnek sonraki yorumda gör. - Peter Huber


Bunu dene:

/// <summary>
/// <para> [Non-Breaking Space] </para>
/// </summary>

[Non-Breaking Space] kullanılarak elde edilir Alt+255 (Numpad'ı kullanarak).

Boş bir yeni hat olarak görünecek. Bunun eski olduğunu biliyorum, ama bugün benim için çalıştı.


46
2018-05-10 20:49



+1: I en sonunda // Magic yazmak için bir yer var, dokunma. - Louis Kottmann
Sadece söylemek istediğim bir şey: WOW! - Joel
Bu, belki de şimdiye kadar gördüğüm aynı seviyelerde aynı anda gerçekleşebilecek en müthiş ve yine de korkunç bir şey. Boş satırlar eklemek için Al Erickson'un önerisini kullanacağım &#160; ama girintilemek için, bu daha güzel. - Daryl
Alt + 0173 büyü gibi görünüyor. Görünmez karakter ve işe yarıyor. - modiX
Alt + 255 VS 2015'te nasıl kullanılır? VS 2015'te Alt + 255'i denediğimde hiçbir şey olmuyor - srh


/// <summary><br />
/// <para>To treat comment line like a DIV tag, surround them with PARA tags.</para><br />
/// <para>To add a break with whitespace, add the following line:</para><br />
/// <para>&#160;</para><br />
/// </summary>

23
2018-03-25 14:58



<br /> yalnız benim için çalıştı. Kullanmak <para> Etiketler, yorumlarımın geri kalanını taşmanın ötesine iten çok fazla dolgu oluşturdu. - drzaus
<para>&#160;</para> aradığım şey buydu tnx :) - Krowi
<br /> VS 2017'de çalışmıyor. - David


Tek umudun, muhtemelen böyle bir şey cludgy:

/// <summary>
/// <para>line one</para>
/// <para>_</para>
/// <para>line two</para>
/// </summary>

7
2018-01-21 22:20



cludgy evet, ama o kadar yakın ki o kadar var - flesh


Eh, bu Xml. Olabilir &#10;&#13;


-2
2018-01-21 22:16



hayır ya bunu yapmaz ... - flesh