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

<?xml version="1.0" encoding="windows-1251"?>

<package>

В <component [id="ComponentID"]>

В В <registration progid="ProgID" class id="GUID" [description="Description"] [version="Version"]>

В  В <script>

Сценарии подключения и отключения

В  В </script>

В В </registration>

В В <public>

В В  <property name="PropertyName">

В В В  <get [internalName="getFunctionName"]/>

В В  В <put [internalName="getFunctionName"]/>

В  В </property>

В В  <method name= "MethodName" [internalName="FunctionName"]>

В В В  <parameter name="ParameterID"/>

В  В </method>

В В  <event name="Name" [dispid="DispID"]/>

В В </public>

  <resource id="ResourceID"> Строка или число </resource>

В В <object id="ObjID" [classld="clsid:GUID"|progid="ProgID"]/>

В В <reference [object="ProgiD"|guid="typelibGUID"][version="version"]/>

В  <script language="language">

В  В <![CDATA[

    Код сценария

В  В ]]>

В  </script>

В </component>

 Другие компоненты

</package>

Несколько замечаний относительно количества вхождений различных XML-элементов из листинга 10.1 в WSC-файл:

□ элемент <package> может содержать один или несколько элементов <component>;

□ элемент <component> должен содержать один элемент <registration> и один элемент <public>;

□ элемент <public> может содержать один или несколько элементов <property>, <method> или <event>.

Обязательными для создания компонента-сценария являются элементы <component>, <registration>, <public> и <script>.

Опишем теперь элементы XML, использующиеся в WSC-файлах, более подробно.

Элементы WSC-файла

В WSC-файлы можно вставлять комментарии двумя разными способами: с помощью элемента <!-- --> или элемента <comment>. Например:

<!-- Первый комментарий -->

или

<comment>

Второй комментарий

</comment>

Элементы <?xml?> и <![CDATA[]]>

Напомним, что эти элементы являются стандартными для разметки W3C XML 1.0 (см. главу 3). Для того чтобы использовать символы кириллицы в файлах компонентов-сценариев, нужно обязательно в элементе <?xml?> указать атрибут encoding со значением, соответствующим используемой кодировке, например:

<?xml version="1.0" encoding="windows-1251"?>

Элемент <package>

Этот элемент необходим в тех WSC-файлах, в которых с помощью элементов <component> определено более одного компонента. В этом случае <package> является контейнером для элементов <component>.

Если же в WSC-файле описан только один компонент, то элемент <package> можно не использовать.

Элемент <component>

Внутри элемента <component> описывается один компонент-сценарий (СОМ-объект). Необязательный атрибут id определяет идентификатор объекта (это может понадобиться в том случае, когда в одном WSC-файле находится несколько СОМ-объектов).

Элемент <registration>

В элементе <registration> приводится информация, которая необходима для регистрации в системе компонента-сценария в качестве СОМ-объекта.

Атрибуты progid Рё classid задают соответственно программный идентификатор Рё глобальный РєРѕРґ, СЃ помощью которых компонент-сценарий может быть использован РІ РґСЂСѓРіРёС… приложениях (например, progid="MyClass.MyObject" Рё classid="{424ac2bc-5732-4dea-be17-0211af99cd79}"). РР· этих РґРІСѓС… атрибутов обязательно должен быть указан хотя Р±С‹ РѕРґРёРЅ (можно указать Рё РѕР±Р°). Если РІ элементе <registration> приведен только атрибут progid, то глобальный РєРѕРґ (GUID) для описываемого объекта будет сгенерирован автоматически РїСЂРё регистрации объекта РІ системе. Рекомендуется, однако, СЏРІРЅРѕ указывать глобальный РєРѕРґ объекта, С‚.Рє. РІ противном случае этот РєРѕРґ может оказаться различным РїСЂРё регистрации объекта РЅР° разных машинах.

Глобальный код объекта может быть сгенерирован с помощью описанной ниже программы Windows Script Component Wizard.

С помощью атрибута description можно задать краткое описание объекта, которое будет занесено в системный реестр при регистрации объекта.

Атрибут version позволяет указать номер версии описываемого объекта. Этот номер позволяет запрашивать из приложения определенную версию СОМ-объекта (он должен быть указан через точку после программного идентификатора объекта, например "Myclass.MyObject.1").

С помощью элемента <script> внутри контейнера <registration> можно указать две функции, одна из которых будет вызываться при регистрации объекта в системе (эта функция должна иметь имя Register()), а другая — при удалении объекта из системы (эта функция должна иметь имя Unregister()).

Элемент <public>

В элементе <public> описываются те свойства, методы и события объекта, которые после его регистрации будут доступны извне другим приложениям (клиентам автоматизации). Другими словами, этот элемент является контейнером для элементов <property>, <method> и <event>.

Элемент <property>

Элемент <property> объявляет свойство СОМ-объекта, которое будет доступно для клиентов автоматизации.

Атрибут name определяет имя этого свойства (в дальнейшем внутри элемента <script> должна быть объявлена глобальная переменная с тем же именем, с помощью которой можно будет изменять значение свойства). Объявляемое свойство может быть доступно либо только для чтения (внутри контейнера <property> указан только элемент <get>), либо только для записи (внутри <property> указан только элемент <put>), либо и для чтения и для записи (внутри <property> указаны как элемент <get>, так и элемент <put>).