Contenido de los archivos de componentes de secuencia de comandos

Los archivos de componentes de secuencia de comandos son XML (lenguaje de marcado extensible) y se parecen mucho a los archivos HTML, pero contienen elementos especiales que definen el componente de secuencia de comandos y su comportamiento. Los elementos que se utilizan para definir componentes de secuencia de comandos no son etiquetas HTML, sino elementos XML que se utilizan específicamente para definiciones de componente de secuencia de comandos.

Un archivo componente de secuencia de comandos básico contiene estos elementos:

Elementos <component> y <package> El elemento <component> incluye una definición completa de componente de secuencia de comandos. Pueden aparecer varios elementos <component> en el mismo archivo .wcs y están contenidos en un elemento <package> principal.
Elemento <registration> Incluye información que se utiliza para registrar el componente de secuencia de comandos como un componente COM. Este elemento puede no ser necesario si la aplicación host (como Microsoft® Internet Explorer 5.0) no utiliza directamente el Registro de Windows al crear una instancia del componente de secuencia de comandos.
Elemento <public> Incluye definiciones de propiedades, métodos y eventos que el componente de secuencia de comandos expone. Las definiciones indican variables o funciones definidas en un bloque <script> independiente.
Elemento <implements> Especifica el controlador de interfaz COM para el componente de secuencia de comandos, que determina el tipo de componente COM que será el componente de secuencia de comandos. Por ejemplo, al especificar <implements type=ASP> se implementa el controlador de interfaz ASP y, por lo tanto, se obtiene acceso al modelo de objetos ASP del componente de secuencia de comandos.
El elemento <public> se utiliza para especificar que un componente de secuencia de comandos implementa el controlador de automatización COM. Por lo tanto, no es necesario crear un elemento <implements> para el controlador de automatización.
Nota El módulo en tiempo de ejecución del componente de secuencia de comandos incluye controladores de interfaz de automatización (expuestos mediante el elemento <public>) para ASP y para componentes de secuencia de comandos de comportamiento de DHTML de Internet Explorer 5.0. Hay disponibles otros controladores de interfaz como archivos DLL externos. Para obtener información acerca de controladores de interfaz y componentes de secuencia de comandos adicionales, consulte el sitio Web de Microsoft Scripting Technologies.
Elemento <script> Contiene la secuencia de comandos que se utiliza para implementar la lógica del componente de secuencia de comandos, según el tipo de componente COM que vaya a crear. Por ejemplo, si crea un componente de automatización COM, declare las propiedades, métodos y eventos en un elemento <public> y, a continuación, escriba la secuencia de comandos para definirlos en uno o más elementos <script>.
Elemento <object> Contiene información acerca de un objeto que se utilice en la secuencia de comandos, como otro componente COM.
Elementos <resource> Contienen valores que no se deben incluir en el código del componente de secuencia de comandos. Los elementos de recursos pueden incluir información que podría cambiar de una versión a otra, cadenas que se podrían traducir y otros valores.
Elemento <reference> Hace referencia a una biblioteca de tipos que desee utilizar en una secuencia de comandos.
Elementos <comment> Contienen texto que se omite cuando el componente de secuencia de comandos se analiza y ejecuta.
Nota Si le preocupa el hecho de que los archivos .wsc que cree contienen XML que se ajuste a los estándares XML, puede especificar que el analizador XML del componente de secuencia de comandos compruebe la sintaxis XML. Por ejemplo, esto puede resultar útil si piensa utilizar en el futuro un editor XML para trabajar con los archivos. Sin embargo, normalmente no debe ser una preocupación. Para obtener más información, consulte Archivos de componentes de secuencia de comandos y compatibilidad XML.

Esquema del archivo componente de secuencia de comandos

El ejemplo siguiente muestra cómo crear un archivo componente de secuencia de comandos.

<?XML version="1.0"?>
<package>
<?component error="true" debug="true"?>
 
   <comment>
      Este esquema muestra cómo se combinan los elementos 
      de un componente de secuencia de comandos en un archivo .wsc.
   </comment>

<component id="MyScriptlet">
   <registration
      progid="IdDePrograma"
      description="descripción"
      version="versión"
      clsid="{00000000-0000-0000-000000000000}"/>

   <reference object="IdDePrograma">
 
   <public>
      <property name="nombrePropiedad"/>
      <method name="nombreMétodo"/>
      <event name="nombreEvento"/>
   </public>

   <implements type=nombreControladorCOM id=nombreInterno>
      (definiciones específicas de la interfaz)
   </implements>

   <script language="VBScript">
      <![CDATA[
      dim nombrePropiedad
      Function nombreMétodo()
      ' Secuencia de comandos.
      End Function
      ]]>
   </script>

   <script language="JScript">
      <![CDATA[
      function get_nombrePropiedad()
      { // Secuencia de comandos.
      }
      function put_nombrePropiedad(nuevoValor)
      { // Secuencia de comandos.
         fireEvent(nombreEvento)
      }
      ]]>
   </script>

   <object id="IdDeObjeto" classid="clsid:00000000-0000-0000-000000000000">
   <resource ID="IdDeRecurso1">cadena o número</resource>
   <resource ID="IdDeRecurso2">cadena o número</resource>
</component>
</package>

Nota En XML puede especificar elementos sin contenido (sólo atributos), como los elementos <property> y <method> del ejemplo anterior si cierra el elemento con />.

Tenga en cuenta lo siguiente:

La declaración <?XML ?> al principio indica que se trata de un archivo XML y que es compatible con el protocolo XML. Esta declaración es opcional; si no la incluye, puede utilizar una sintaxis un poco más relajada al crear los elementos del componente de secuencia de comandos. Para obtener más información, consulte Archivos de componentes de secuencia de comandos y compatibilidad XML.
El elemento <package> es opcional en este ejemplo, ya que el archivo sólo contiene un único elemento <component>.
La instrucción de proceso <?component?> incluye atributos para especificar las opciones de comprobación de errores. Para obtener más información, consulte Comprobar errores en archivos de Script Component. Si no incluye este elemento, todas las opciones predeterminadas toman el valor false.
Los elementos <comment> pueden aparecer en cualquier parte del componente de secuencia de comandos.
Los elementos <registration> no son necesarios en todos los casos. Por ejemplo, no es necesario registrar un componente de secuencia de comandos que implemente el controlador de interfaz de comportamiento de DHTML en Internet Explorer 5.0, porque Internet Explorer crea una instancia directamente de los componentes de secuencia de comandos de comportamiento a medida que se detectan en la página. Para obtener información acerca de los requisitos de registro, consulte la documentación del controlador de interfaz que vaya a implementar y tenga en cuenta también en qué host se utilizará el componente de secuencia de comandos.
Los elementos <reference> permiten incluir una biblioteca de tipos en el componente de secuencia de comandos para que pueda utilizar las constantes de la biblioteca en la secuencia de comandos.
El elemento <public> encierra los elementos <property>, <method> y <event>. La secuencia de comandos que los define aparece más adelante en el archivo componente de secuencia de comandos.
El elemento <implements> se utiliza para poner a disposición las interfaces COM no predeterminadas. Por ejemplo, puede exponer la interfaz ASP con un tipo <implements> como el siguiente:
```
<implements type="ASP" id="iASP">
```
Los elementos exactos que aparecen dentro de <implements> depende del tipo de interfaz que se implemente.
Nota El elemento <implements> se muestra aquí con un Id. de atributo. Sin embargo, este atributo es opcional, excepto en los casos en los que se debe deshacer la ambigüedad entre objetos o variables. Para obtener información, consulte el elemento <implements>.
En este esquema, hay dos elementos de secuencia de comandos, uno para VBScript y otro para JScript. Si sólo utiliza un único lenguaje de secuencia de comandos, sólo necesitará un elemento <script>. Debido a que la declaración <?XML ?> aparece al principio del archivo, es necesario incluir una sección CDATA para hacer opaca la secuencia de comandos del elemento <script>. Para obtener más información, consulte Archivos de componentes de secuencia de comandos y compatibilidad XML.
El elemento <object> crea una referencia a un objeto que desee utilizar en secuencias de comandos dentro del componente de secuencia de comandos.

Después de crear el esquema, escriba los elementos para definir la funcionalidad del componente de secuencia de comandos, según el controlador de interfaz que implemente.

Consulte también

Comprobar errores en archivos de Script Component | Crear una biblioteca de tipos de Script Component | Crear información de registro | Exponer eventos | Exponer métodos | Exponer propiedades | Implementar componentes de secuencia de comandos ASP | Implementar componentes de secuencia de comandos de comportamiento DHTML | Archivos de componentes de secuencia de comandos y compatibilidad XML | Utilizar el Asistente para componentes de secuencia de comandos