Kommentaaride lisamine ASP-s
Mõnikord ajavad inimesed segadusse lihtsad asjad. Kuidas lisada oma ASP-koodile kommentaare, et see oleks paremini loetav ja dokumenteeritav?

See on väga lihtne - panite lihtsalt ühe pakkumise (') ASP-rea algusesse. Nii võib teie kood välja näha selline -

'lähtesta muutujad'
CurrMonth = taotlus ("m")
CurrDay = taotlus ("d")

Pange tähele, et ma panin enne kommentaari JA pärast seda apostrofe. Sa ei pea seda tegema. Kuid ma kasutan TextPadi redaktorit (mida ma väga soovitan) ja see tõstab asjad automaatselt esile vastavalt sellele, kus apostroof algab ja lõpeb. Nii et panen kommentaaride mõlemale otsale ühe, muudaksin need kõik erinevat värvi.

Kommentaare EI tõlgendata, nii et saate neile lisada kõike, mida soovite. Ehkki kommentaarid on olulised, et oma tegemistega silma peal hoida, ei soovita ma MITTE kommentaare oma koodi lisada. Pidage meeles, et enne tulemuse lõppkasutajale saatmist tuleb kogu teie fail parsida ja töödelda. Kui kirjutate oma kommentaarides sõda ja rahu, kulub natuke aega, enne kui see fail teie lõppkasutajani jõuab - see tähendab, et nad võivad loobuda ja mujale minna. Soovite, et teie aktiivsed ASP-lehed oleksid võimalikult sujuvad.

Seetõttu soovitan kommentaarid lisada iga suurema koodiploki kohale, nii et kui peate sisse logima ja seda mitu kuud hiljem siluma, saate meelde jätta, mida te tegite. Võib-olla lisage ülaosas rida või kaks koos viimase muudatuse kuupäeva ja autori nimega. Kuid jätke kogu jõuline dokumentatsioon eraldi. ASP-koodi peamine eesmärk on lõppkokkuvõttes kasutajale veebilehe loomine - ja selles mõttes on kiire tegutsemine esmatähtis.

Video Juhiseid: Which Came First - The Chicken or the Egg? (Märts 2024).