Глава 29. Язык VBScrip 737
Блок комментариев с отступом в один пробел
Код высшего уровня с отступом в 4 пробела
Вложенный блок кода с отступом в 4 пробела
Рис. 29.3.В окне редактора Notepad виден скрипт, отформатированный в соответствии с принятыми соглашениями
( Примечани )
Компания Microsoft рекомендует располагать все процедуры в разделе <HEAD>документа. В этом случае весь код скрипта будет расположен в одном месте. Альтернативным вариантом расположения является размещение процедур-обработчиков событий объектов как можно ближе к описанию соответствующего объекта. В последнем случае скрипты будут располагаться в разделе <BODY>документа.
Соглашения по записи комментариев
Комментарии представляют собой текст, который никак не влияет на работу скрипта. Целью записи комментариев является пояснение ваших намерений, а также разъяснение блоков кода, смысл которых не столь очевиден. Каждая строчка комментария начинается с символа апострофа ('). Язык VBScript игнорирует все содержимое строки от символа апострофа и до ее конца. Интерпретация кода продолжается с начала следующей строки. Для комментария может использоваться целиком вся строка, а может использоваться конец строки, содержащей код. Приведем примеры:
'The following code does this, that, and other
intAge=29 'My wife's perpetual age
Начинайте каждую процедуру с кратких комментариев, описывающих ее действия.Неописывайте подробно (как это работает), так как детали часто меняются. Подробное описание потребует постоянного обновления комментариев в процессе редактирования кода процедуры. Вместо этого опишите,
24 Зак. 535