Андрей Попов - Windows Script Host для Windows 2000/XP

Рис. 3.7.Диалоговое окно, формируемое элементами и

Сценарий example.wsf, диалоговое окно с описанием которого показано на рис. 3.7, приведен в листинге 3.6.

Имя: example.wsf

Кодировка: Windows

Описание: Здесь можно привести дополнительное описание сценария

Здесь приводится пример запуска сценария

(с параметрами командной строки, например)

//Вызываем метод ShowUsage

WScript.Arguments.ShowUsage();

Элемент позволяет отделить символьные или числовые константы (ресурсы) от остального кода сценария. Например, таким образом удобно собрать в одном месте строки, которые используются в сценарии для вывода каких-либо стандартных сообщений. Если после этого понадобится изменить сообщения в сценарии (например, перевести их на другой язык), то достаточно будет внести соответствующие корректировки в строки, описанные в элементах .

Для получения значения ресурса в сценарии нужно вызвать метод getResource, передав в качестве параметра символьный идентификатор ресурса (значение атрибута id).

В листинге 3.7 представлен пример сценария resource.wsf, в котором определяется ресурсная строка с идентификатором " MyName":

Меня зовут Андрей Попов

Значение этого ресурса затем выводится на экран с помощью метода Echo объекта WScriptи метода getResource:

WScript.Echo(getResource("MyName"));

Имя: resource.wsf

Описание: Пример использования в сценарии ресурсных строк

Меня зовут Андрей Попов

//Выводим на экран значение ресурса "MyName"

WScript.Echo(getResource("MyName"));

Элемент предлагает еще один способ создания экземпляра COM-объектов для использования их внутри сценариев. Напомним, что ранее для этого мы использовали методы CreateObjectи GetObjectобъекта WScript, объект ActiveXObjectи функцию GetObjectязыка JScript, а также функцию CreateObjectязыка VBScript. Элемент может заменить эти средства.

Атрибут idв — это имя, применяемое для обращения к объекту внутри сценария. Отметим, что объект, создаваемый с помощью тега , будет глобальным по отношению к тому заданию, в котором он определен. Другими словами, этот объект может использоваться во всех элементах , находящихся внутри элемента , содержащего описание объекта.

Атрибуты classidи progidиспользуются в соответственно для указания глобального кода создаваемого объекта (GUID, Globally Unique ID) или программного кода объекта (Programmic Identifier). Из этих двух необязательных атрибутов может быть указан только один. Например, создать объект FileSystemObject (GUID="0D43FE01-F093-11CF-8940-00A0C9054228")можно двумя способами:

или

В обычном js-файле или внутри элемента этот объект мы бы создали следующим образом:

var fso = WScript.CreateObject("Scripting.FileSystemObject");

или

var fso = new ActiveXObject("Scripting.FileSystemObject");

При вызове многих методов внешних объектов, которые используются внутри сценариев, требуется указывать различные числовые или строковые константы, определенные в этих внешних объектах. Например, для того, чтобы открыть текстовый файл с помощью метода OpenTextFileобъекта FileSystemObject, может потребоваться указать параметр, который определяет режим ввода/вывода (возможные значения констант ForReading=1, ForWriting=2и ForAppending=8) открываемого файла. Ясно, что запомнить все значения констант различных объектов очень трудно, поэтому при их использовании приходится постоянно обращаться к справочной информации.

К счастью, большинство объектов предоставляет информацию об именах используемых ими констант в своей библиотеке типов (как уже отмечалось в главе 2, библиотека типов регистрируется в системном реестре при установке СОМ-объекта и может существовать как в виде отдельного файла с расширением tlb, так и в виде части файла с исполняемым кодом объекта). Элемент как раз обеспечивает доступ к мнемоническим константам, определенным в библиотеке типов объекта (экземпляр объекта при этом не создается).

Для того чтобы воспользоваться константами определенного объекта, нужно в теге указать программный код этого объекта (атрибут object) или глобальный код его библиотеки типов (атрибут guid), а также, при необходимости, номер версии объекта (атрибут version).

Например, доступ к константам объекта FileSystemObjectорганизуется следующим образом:

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

Элемент с помощью атрибута languageпозволяет определить язык сценария ( language="JScript"для языка JScript и language="VBScript"для языка VBScript). Это делает возможным использовать в одном задании сценарии, написанные на разных языках, что иногда бывает очень удобно. Предположим, что у вас имеются сценарии на JScript и VBScript, функции которых необходимо объединить. Для этого не нужно переписывать один из сценариев на другой язык — используя WS-файл, можно из сценария JScript спокойно вызывать функции, написанные на VBScript, и наоборот! Пример подобного сценария приведен в листинге 3.12.

Атрибут srcпозволяет подключить к выполняющемуся сценарию внешний файл с другим сценарием. Например, задание элемента

приведет к такому же результату, как если бы содержимое файла tools.js было расположено между тегами и :

Содержимое файла tools.js

Таким образом, можно выделить код, который должен использоваться в нескольких сценариях, поместить его в один или несколько внешних файлов, а затем по мере необходимости просто подключать с помощью атрибута srcэти файлы к другим сценариям.

Элемент является вторым обязательным элементом в сценариях WSH с разметкой XML.

Приведем примеры сценариев, иллюстрирующие основные свойства WS-файлов.

Напомним, что здесь обязательными являются элементы и . Соответствующий пример сценария strict.wsf приведен в листинге 3.8.

Имя: strict.wsf

Кодировка: Windows

Описание: Пример строгого режима обработки WS-файла

WScript.Echo("Всем привет!");

]]>

Каждое отдельное задание в WS-файле должно находиться внутри элементов и . В свою очередь, все элементы являются дочерними элементами контейнера .