Jei norite pridėti nuorodos komentarų prie savo XML kodas, naudokite šią nuoseklią mokymo programą. Galite sužinoti, kaip šią funkciją atlikti tik per penkias minutes. Nors procesą lengva atlikti, prieš pradėdami vis tiek turėtumėte žinoti keletą XML komentarų pagrindų ir jų naudingumo.
Kodėl XML komentarai yra naudingi
XML komentarai yra beveik identiški HTML komentarams, nes jų abiejų sintaksė yra ta pati. Naudojant komentarus leidžia suprasti kodą, kurį parašėte prieš metus. Tai taip pat gali padėti kitam kūrėjui, kuris peržiūri jūsų sukurtą kodą, suprasti, ką parašėte. Trumpai tariant, šie komentarai pateikia kodo kontekstą.
Su komentarais galite lengvai palikti užrašą arba laikinai pašalinti dalį XML kodo. Nors XML yra sukurtas taip, kad „apibūdintų duomenis“, kartais gali tekti palikti XML komentarą.
Pradžia
Komentarų žymas sudaro dvi dalys: komentarą pradedanti dalis ir jį baigianti dalis. Norėdami pradėti, pridėkite pirmąją komentaro žymos dalį:
Tada parašyk kokį komentarą norėtum. Tiesiog įsitikinkite, kad komentarai nėra įdėti į kitus komentarus (daugiau informacijos rasite patarimuose). Po to uždarysite komentaro žymą:
-->
Naudingi patarimai
Pridėdami nuorodinius komentarus prie savo XML kodo, atminkite, kad jie negali būti pačiame jūsų dokumento viršuje. XML sistemoje pirmiausia gali būti tik XML deklaracija:
Kaip minėta pirmiau, komentarai negali būti įterpti vienas į kitą. Prieš atidarydami antrą, turite uždaryti savo pirmąjį komentarą. Be to, žymose negali būti komentarų, pvz.
.
Niekada nenaudokite dviejų brūkšnių (-) bet kur, išskyrus komentarų pradžioje ir pabaigoje. Viskas, kas yra komentaruose, yra faktiškai nematoma XML analizatorius, todėl būkite labai atsargūs, kad tai, kas liko, vis dar galioja ir gerai suformuota.
Apvyniojimas
Jei vis dar turite klausimų apie nuorodų komentarų pridėjimą prie XML kodo, galbūt norėsite perskaityti knygą, kad gautumėte išsamų proceso veikimo vaizdą. Tokios knygos kaipRodo Stephenso „C # 5.0 programuotojo nuoroda“ gali pasirodyti naudinga.