Шрифт:
</description>
</runtime>
<script language="JScript">
//Вызываем метод ShowUsage
WScript.Arguments.ShowUsage;
</script>
</job>
Элемент <example>
Внутри элемента
<example>
приводится текст из одной или нескольких строк, в котором можно описать примеры запуска сценария. Если сценарий был запущен с ключом /?
в командной строке или в сценарии встретился вызов метода ShowUsage
объекта WshArguments
, то этот текст выводится в графическое диалоговое окно (при использовании wscript.exe) или на экран (в консольном режиме при использовании cscript.exe). При выводе текста на экран учитываются все имеющиеся в нем пробелы, символы табуляции и перевода строки, при этом строки из элемента <example>
выводятся после строк из элемента <description>
(рис. 3.7). Рис. 3.7. Диалоговое окно, формируемое элементами
<description>
и <example>
Сценарий example.wsf, диалоговое окно с описанием которого показано на рис. 3.7, приведен в листинге 3.6.
Листинг 3.6. Файл example.wsf
<job id="Example">
<runtime>
<description>
Имя: example.wsf
Кодировка: Windows
Описание: Здесь можно привести дополнительное описание сценария
</description>
<example>
Здесь приводится пример запуска сценария
(с параметрами командной строки, например)
</example>
</runtime>
<script language="JScript">
//Вызываем метод ShowUsage
WScript.Arguments.ShowUsage;
</script>
</job>
Элемент <resource>
Элемент
<resource>
позволяет отделить символьные или числовые константы (ресурсы) от остального кода сценария. Например, таким образом удобно собрать в одном месте строки, которые используются в сценарии для вывода каких-либо стандартных сообщений. Если после этого понадобится изменить сообщения в сценарии (например, перевести их на другой язык), то достаточно будет внести соответствующие корректировки в строки, описанные в элементах <resource>
. Для получения значения ресурса в сценарии нужно вызвать метод
getResource
, передав в качестве параметра символьный идентификатор ресурса (значение атрибута id). В листинге 3.7 представлен пример сценария resource.wsf, в котором определяется ресурсная строка с идентификатором "
MyName
": <resource id="MyName"> Меня зовут Андрей Попов </resource>
Значение этого ресурса затем выводится на экран с помощью метода
Echo
объекта WScript
и метода getResource
: WScript.Echo(getResource("MyName"));
Листинг 3.7. Файл resource.wsf
<job id="Resource">
<runtime>
<description>
Имя: resource.wsf
Описание: Пример использования в сценарии ресурсных строк
</description>
</runtime>
<resource id="MyName">
Меня зовут Андрей Попов
</resource>
<script language="JScript">
//Выводим на экран значение ресурса "MyName"
WScript.Echo(getResource("MyName"));
</script>
</job>
Элемент <object>
Элемент
<object>
предлагает еще один способ создания экземпляра COM-объектов для использования их внутри сценариев. Напомним, что ранее для этого мы использовали методы CreateObject
и GetObject
объекта WScript
, объект ActiveXObject
и функцию GetObject
языка JScript, а также функцию CreateObject
языка VBScript. Элемент <object>
может заменить эти средства. Атрибут
id
в <object>
— это имя, применяемое для обращения к объекту внутри сценария. Отметим, что объект, создаваемый с помощью тега <object>
, будет глобальным по отношению к тому заданию, в котором он определен. Другими словами, этот объект может использоваться во всех элементах <script>
, находящихся внутри элемента <job>
, содержащего описание объекта. Атрибуты
classid
и progid
используются в <object>
соответственно для указания глобального кода создаваемого объекта (GUID, Globally Unique ID) или программного кода объекта (Programmic Identifier). Из этих двух необязательных атрибутов может быть указан только один. Например, создать объект FileSystemObject (GUID="0D43FE01-F093-11CF-8940-00A0C9054228")
можно двумя способами: