Tartalomjegyzék:

Hogyan adhatok hozzá megjegyzéseket az XML-hez a Visual Studióban?
Hogyan adhatok hozzá megjegyzéseket az XML-hez a Visual Studióban?

Videó: Hogyan adhatok hozzá megjegyzéseket az XML-hez a Visual Studióban?

Videó: Hogyan adhatok hozzá megjegyzéseket az XML-hez a Visual Studióban?
Videó: 8.3 Document Comments - Learning C# 2024, Április
Anonim

XML megjegyzések beszúrása egy kódelemhez

  1. Írja be: /// C#-ban, vagy '''' betűvel Visual Basic .
  2. A Szerkesztés menüből válassza az IntelliSense > lehetőséget Megjegyzés beszúrása .
  3. A kódelemen vagy közvetlenül felette található jobb gombbal vagy helyi menüben válassza a Kivonat > lehetőséget Megjegyzés beszúrása .

Sőt, hogyan írhatok megjegyzéseket XML-ben?

Ha akarod megjegyzés ki egyetlen sort a XML kódot, helyezze a kurzort a kívánt sor elejére megjegyzés ki. Írjon be egy kisebb, mint szimbólumot, majd egy felkiáltójelet és két kötőjelet. Vigye a kurzort a sor végére, majd írjon be két kötőjelet, majd egy nagyobb, mint szimbólumot.

Felmerülhet az is, hogy hogyan tudom kommentálni a kódot C#-ban? Nak nek kód a megjegyzés , írjon be egy dupla perjelet, majd a megjegyzés . Ezzel a technikával hozzáadhatja a megjegyzés saját sorában vagy hozzáadásához a megjegyzés azután kód egy vonalon. Gyakran amikor te kód , érdemes lehet megjegyzés egy egész blokkon kód nyilatkozatok.

Másodszor, mik azok az XML megjegyzések a C#-ban?

Az egyik ilyen XML Dokumentáció Hozzászólások , néha hívják XML megjegyzések , amely hármas perjellel kezdődik - ///. XML megjegyzések használható a Visual Studio és a VS Code IntelliSense szolgáltatása által egy típusra vagy tagra vonatkozó információk megjelenítésére; ezek az információk a kóddokumentációban szereplő adatokból származnak.

Hogyan dokumentálja a kódot?

A dokumentáció írásának legjobb gyakorlatai:

  1. Tartalmazzon egy README fájlt, amely tartalmazza.
  2. A problémakövető engedélyezése mások számára.
  3. Írjon API-dokumentációt.
  4. Dokumentálja a kódját.
  5. Alkalmazzon kódolási konvenciókat, például fájlszervezést, megjegyzéseket, elnevezési konvenciókat, programozási gyakorlatokat stb.
  6. Tartalmazzon információkat a közreműködők számára.

Ajánlott: