Глава 29. Язык VBScrip 737

Блок комментариев с отступом в один пробел

Код высшего уровня с отступом в 4 пробела

Вложенный блок кода с отступом в 4 пробела

h07371.jpg

Рис. 29.3.В окне редактора Notepad виден скрипт, отформатированный в соответствии с принятыми соглашениями

( Примечани )

Компания Microsoft рекомендует располагать все процедуры в разделе <HEAD>документа. В этом случае весь код скрипта будет расположен в одном месте. Альтернативным вариантом расположения является размещение процедур-обработчиков событий объектов как можно ближе к описанию соответствующего объекта. В последнем случае скрипты будут располагаться в разделе <BODY>документа.

Соглашения по записи комментариев

Комментарии представляют собой текст, который никак не влияет на работу скрипта. Целью записи комментариев является пояснение ваших намерений, а также разъяснение блоков кода, смысл которых не столь очевиден. Каждая строчка комментария начинается с символа апострофа ('). Язык VBScript игнорирует все содержимое строки от символа апострофа и до ее конца. Интерпретация кода продолжается с начала следующей строки. Для комментария может использоваться целиком вся строка, а может использоваться конец строки, содержащей код. Приведем примеры:

'The following code does this, that, and other

intAge=29 'My wife's perpetual age

Начинайте каждую процедуру с кратких комментариев, описывающих ее действия.Неописывайте подробно (как это работает), так как детали часто меняются. Подробное описание потребует постоянного обновления комментариев в процессе редактирования кода процедуры. Вместо этого опишите,

24 Зак. 535