Για να εμφανίσετε σχόλια XML σε μια νέα γραμμή

Στο Visual Studio, μπορείτε να γράψετε σχόλια εγγράφου XML σε C# και VB.NET ιδιότητες και μεθόδους. Μόλις το γράψετε, θα μπορείτε να δείτε την περιγραφή της ιδιότητας ή της μεθόδου όταν το γράφετε σε κώδικα, τοποθετήστε το δείκτη του ποντικιού και χρησιμοποιήστε ένα εργαλείο όπως "Sandcastle".

Ωστόσο, εάν γράφετε πάρα πολύ, η αναγνωσιμότητα θα μειωθεί, οπότε συνήθως θα το γράψετε σε περίπου μία γραμμή, αλλά σε ορισμένες περιπτώσεις μπορεί να θέλετε να το εμφανίσετε σε πολλές γραμμές.

Εάν σπάσετε μια γραμμή σε ένα σχόλιο κανονικά, θα περιμένετε να εμφανίζεται με μια αλλαγή γραμμής όταν εμφανίζεται η περιγραφή, αλλά όταν το δοκιμάσετε πραγματικά, θα εμφανιστεί ως εξής.

/// <summary>
/// これは
/// 普通に
/// 改行したもの
/// <summary>
public int Amount1 { get; set; }

Αποτέλεσμα εμφάνισης επεξήγησης

Δεν υπάρχουν αλλαγές γραμμής στο κείμενο περιγραφής και η διάταξη φαίνεται σαν να περιέχει κενά διαστήματα. Η XML έχει διαφορετική επίδραση στον τρόπο χειρισμού των κενών και των αλλαγών γραμμής και το Visual Studio δεν θεωρεί ότι οι κανονικές αλλαγές γραμμής είναι αλλαγές κειμένου.

Έτσι, εάν θέλετε να σπάσετε το κείμενο περιγραφής σε μια γραμμή, πώς να το κάνετε είναι να χρησιμοποιήσετε την ετικέτα "para". "para" σημαίνει "παράγραφος". Περικλείστε τις μονάδες που θέλετε να αλλάξετε γραμμές όπως αυτή σε μια ετικέτα para:

/// <summary>
/// <para>paraを</para>
/// <para>使って</para>
/// <para>改行したもの</para>
/// </summary>
public int Amount2 { get; set; }

Η περιγραφή εμφανίζεται με αλλαγή γραμμής όπως φαίνεται στην εικόνα. Εάν χρησιμοποιείτε το εργαλείο δημιουργίας εγγράφων, θα εμφανίζεται επίσης ως παράγραφος με αλλαγές γραμμής.