脚本部件文件的内容

Windows® 脚本部件文件采用 XML (可扩展标记语言)来编写，这种文件与 HTML 文件很相似，但包含了用于定义脚本部件及其操作的特有元素。用来定义脚本部件的元素不是 HTML 标记，而是专门用于脚本部件定义的 XML 元素。

一个基本的脚本部件文件包含这些元素：

<component> 和 <package> 元素 <component> 元素包含的是一个完整的脚本部件定义。在同一个 .wsc 文件中可以出现多个 <component> 元素，但这些元素应包含在一个 <package> 元素内。
<registration> 元素 包括用来将脚本部件注册为 COM 部件的信息。如果宿主应用程序（如 Microsoft® Internet Explorer 5.0）在创建该脚本部件的实例时没有直接使用 Windows 注册表，则该元素不是必需的。
<public> 元素 包含脚本部件所说明的属性、方法和事件的定义。这些定义指向定义在独立的 <script> 块中的变量或函数。
<implements> 元素给脚本部件指定 COM 接口处理程序，这将确定该脚本部件属于哪种 COM 部件类型。例如，通过指定 <implements type=ASP>，就可以实现 ASP 接口处理程序，并因此在脚本部件中可以访问 ASP 对象模型。
<public> 元素即指定了脚本部件将实现 COM Automation 接口处理程序。因此，对 Automation 处理程序无需创建 <implements> 元素。
注意脚本部件运行库包括用于 Automation （使用 <public> 元素说明的）、用于 ASP 以及用于 Internet Explorer 5.0 DHTML Behavior 的接口处理程序。其他接口处理程序可以作为外部 DLL 获得。关于附加的接口处理程序和脚本部件的详细信息，请参阅 Microsoft Scripting Technologies Web 站点。
<script> 元素 包含用来实现脚本部件逻辑的脚本，这取决于所创建的 COM 部件类型。例如，如果要创建的是 COM Automation 部件，则可以在 <public> 元素中声明属性、方法和事件，然后用一个或多个 <script> 元素编写脚本来定义这些内容。.
<object> 元素 包含脚本中所使用的某个对象的信息，如另一个 COM 部件的信息。
<resource> 元素 包含不应被硬编码到脚本部件代码中的值。资源元素可能包括在各个版本间可能更改的信息，可能需要翻译的字符串以及其他值。
<reference> 元素 引用在脚本中需要使用的类型库。
<comment> 元素 包含在分析和执行该脚本部件时将被忽略的文字。
注意如果希望所创建的 .wsc 文件的 XML 遵守 XML 标准，您可以指定脚本部件的 XML 语法分析器检查 XML 语法。例如，如果今后可能会使用 XML 编辑器来编辑该文件，那么这种要求是很有用的。不过，这通常是不受关注的。详细信息请参阅脚本部件文件和 XML 一致性。

脚本部件文件的框架

下面的示例演示了一个脚本部件文件的结构。

<?XML version="1.0"?>
<package>
<?component error="true" debug="true"?>

   <comment>
      本框架演示了脚本部件的各种元素
      在 .wsc 文件中是如何安置的。
   </comment>

<component id="MyScriptlet">
   <registration
      progid="progID"
      description="description"
      version="version"
      clsid="{00000000-0000-0000-000000000000}"/>

   <reference object="progID">

   <public>
      <property name="propertyname"/>
      <method name="methodname"/>
      <event name="eventname"/>
   </public>

   <implements type=COMhandlerName id=internalName>
      (interface-specific definitions here)
   </implements>

   <script language="VBScript">
      <![CDATA[
      dim propertyname
      Function methodname()
      ' Script here.
      End Function
      ]]>
   </script>

   <script language="JScript">
      <![CDATA[
      function get_propertyname()
      { // Script here.
      }
      function put_propertyname(newValue)
      { // Script here.
         fireEvent(eventname)
      }
      ]]>
   </script>

   <object id="objID" classid="clsid:00000000-0000-0000-000000000000">
   <resource ID="resourceID1">string or number here</resource>
   <resource ID="resourceID2">string or number here</resource>
</component>
</package>

注意在 XML 中，您可以指定没有内容的元素（只有属性），如上面示例中的 <property> 和 <method> 元素，方法是用 />来结束该元素。

请注意：

在开始处的 <?XML ?> 声明说明这是一个 XML 文件，将遵守 XML 协议。该声明是可选的；如果遗漏该声明，则在创建该脚本部件的元素时可以使用稍微宽松一些的语法。详细信息请参阅脚本部件文件和 XML 一致性。
在本示例中 <package> 元素是可选的，因为该文件只包含一个 <component> 元素。
<?component?> 处理指令包括用来指定错误检查选项的特性。详细信息请参阅检查脚本部件文件中的错误。如果没有包括该元素，则缺省选项是所有都不选中。
<comment> 元素可以出现在脚本部件中的任何位置。
在所有情况下 <registration> 元素都不是必需的。例如，如果脚本部件实现的是 Internet Explorer 5.0 中的 DHTML Behavior 接口处理程序，则不需要进行注册，因为 Internet Explorer 直接在页面上按照所检测的操作进行实例化。有关注册要求的详细信息，请参阅所要实现的接口处理程序的有关文档，此外也要注意使用该脚本部件将是哪种主机。
<reference> 元素允许您在脚本部件中包括一个类型库，以便在脚本中使用这个库的常数。
<public> 元素内包括了 <property>、<method> 和 <event> 元素。相应的定义这些内容的脚本位于脚本部件文件的后面。
<implements> 元素可以用来获得非缺省的 COM 接口。例如，您可以通过下述方式用 <implements> 的 type 来说明 ASP 接口：
```
<implements type="ASP" id="iASP">
```
在 <implements> 元素中出现的确切元素取决于您所要实现的接口类型。
注意此处显示的 <implements> 元素有一个 id 属性。不过，该属性是可选的，除非必须区分对象或变量。详细信息请参阅 <implements> 元素。
在这个框架文件中有两个脚本元素，一个用于 VBScript，一个用于 JScript。如果您只使用一种脚本语言，则不需多个<script> 元素。由于文件的开始有 <?XML ?> 声明，因此必需要有一个 CDATA 项来使 <script> 元素中的脚本不透明。详细信息请参阅脚本部件文件和 XML 一致性。
<object> 元素创建指向该脚本部件的脚本中所使用的对象的引用。

在创建该框架后，再根据所要实现的接口处理程序，来填充这些元素以定义该脚本部件的功能。

请参阅