Ha érdekel, hogy hozzáadjon referencia megjegyzéseket a XML kód, útmutatásként használja ezt a lépésenkénti oktatóanyagot. Megtanulhatja, hogyan hajtsa végre ezt a funkciót mindössze öt perc alatt. Noha a folyamat könnyen elvégezhető, a kezdés előtt még mindig ismernie kell az XML megjegyzések és azok hasznosságának néhány alapját.
Miért hasznosak az XML-megjegyzések?
Az XML-ben szereplő megjegyzések közel azonosak a HTML-ben szereplő megjegyzésekkel, mivel mindkettőjük azonos szintaxissal rendelkezik. Megjegyzések használata lehetővé teszi, hogy megértse a kódot, amelyet évekkel korábban írt. Ez segíthet egy másik fejlesztőnek is, aki áttekinti az Ön által kifejlesztett kódot, hogy megértse, amit írt. Röviden, ezek a megjegyzések kontextust adnak a kódnak.
Megjegyzésekkel könnyen megjegyzést hagyhat, vagy ideiglenesen eltávolíthat egy XML-kódot. Annak ellenére, hogy az XML-t úgy tervezték, hogy "önmagát leíró adat" legyen, előfordulhat, hogy XML-megjegyzést kell tennie.
Elkezdeni
A megjegyzéscímkék két részből állnak: a megjegyzés kezdő és az azt befejező részből. Először adja hozzá a megjegyzés címke első részét:
Ezután írjon meg bármilyen megjegyzést, amit szeretne. Csak győződjön meg róla, hogy nem fűzi be a megjegyzéseket más megjegyzésekbe (további részletekért lásd a tippeket). Ezt követően bezárja a megjegyzés címkét:
-->
Hasznos tippek
Amikor referencia-megjegyzéseket ad hozzá az XML-kódhoz, ne feledje, hogy azok nem kerülhetnek a dokumentum legfelülre. XML-ben csak az XML-deklaráció lehet az első:
Mint fent említettük, előfordulhat, hogy a megjegyzések nem kerülnek egymásba. Bezárja az első megjegyzését, mielőtt megnyitja a másodikat. Emellett a címkéken belül nem fordulhatnak elő megjegyzések, pl.
.
Soha ne használja a két kötőjelet (-) sehol, csak a megjegyzései elején és végén. A megjegyzésekben bármi gyakorlatilag láthatatlan a XML elemző, ezért nagyon vigyázzon, hogy a maradék továbbra is érvényes és jól formált legyen.
Csomagolás
Ha még mindig kérdései vannak a referencia megjegyzések XML-kóddal való hozzáadásával kapcsolatban, érdemes elolvasnia egy könyvet, hogy részletes képet kapjon a folyamat működéséről. Könyvek, mint plRod Stephens "C # 5.0 programozói referenciája" hasznosnak bizonyulhat.