Ja jūs vēlaties pievienot atsauces komentārus savam XML kods, izmantojiet šo soli pa solim sniegto pamācību. Jūs varat uzzināt, kā izpildīt šo funkciju tikai piecās minūtēs. Lai gan procesu ir viegli pabeigt, pirms darba uzsākšanas jums joprojām vajadzētu zināt dažus pamatus par XML komentāriem un to lietderību.
Kāpēc XML komentāri ir noderīgi
XML komentāri ir gandrīz identiski HTML komentāriem, jo tiem abiem ir vienāda sintakse. Izmantojot komentārus ļauj saprast kodu, kuru rakstījāt gadus iepriekš. Tas var arī palīdzēt citam izstrādātājam, kurš pārskata jūsu izstrādāto kodu, lai saprastu jūsu rakstīto. Īsāk sakot, šie komentāri sniedz koda kontekstu.
Izmantojot komentārus, jūs varat viegli atstāt piezīmi vai īslaicīgi noņemt daļu no XML koda. Kaut arī XML ir veidots kā "sevi raksturojoši dati", dažreiz jums var nākties atstāt XML komentāru.
Darba sākšana
Komentāru tagus veido divas daļas: daļa, kas sāk komentāru, un daļa, kas to beidz. Lai sāktu, pievienojiet komentāra taga pirmo daļu:
Tad uzrakstiet komentāru, kuru vēlaties. Vienkārši pārliecinieties, ka komentāri nav ievietoti citos komentāros (sīkāku informāciju skatiet padomos). Pēc tam jūs aizvērsiet komentāra tagu:
-->
Noderīgi padomi
Pievienojot atsauces komentārus savam XML kodam, atcerieties, ka tie nevar atrasties pašā dokumenta augšdaļā. XML failā vispirms var būt tikai XML deklarācija:
Kā minēts iepriekš, komentārus nedrīkst ievietot savā starpā. Pirms otra atvēršanas jums ir jāaizver pirmais komentārs. Arī komentāri nevar būt tagos, piem.
.
Nekad nelietojiet abas domuzīmes (-) nekur citur, tikai komentāru sākumā un beigās. Viss komentāros ir faktiski neredzams XML parsētājs, tāpēc esiet ļoti uzmanīgs, lai tas, kas paliek, joprojām būtu derīgs un labi izveidots.
Iesaiņošana
Ja jums joprojām ir jautājumi par atsauces komentāru pievienošanu XML kodam, ieteicams izlasīt grāmatu, lai sniegtu detalizētu priekšstatu par procesa darbību. Tādas grāmatas kāRod Stephens "C # 5.0 programmētāja atsauce" var izrādīties noderīga.