Crear información de registro

Si la aplicación host lo requiere, puede registrar un componente de secuencia de comandos como un componente COM mediante un programa como Regsvr32.exe. El proceso de registro coloca la información del componente COM en una ubicación pública (en Windows, la información de registro se almacena en el Registro de Windows). Al leer la información de registro, las aplicaciones pueden buscar y cargar el componente COM.

Nota El proceso de registro no es necesario en todos los casos. Por ejemplo, no es necesario registrar un componente de secuencia de comandos que implemente el controlador de interfaz de comportamientos DHTML en Internet Explorer 5.0 porque Internet Explorer registra los componentes de secuencia de comandos de comportamiento a medida que se detectan en la página. Para obtener más información acerca del uso de estos componentes de secuencia de comandos, consulte "Uso de componentes de secuencia de comandos de comportamiento DHTML" en el sitio Web de Microsoft Site Builder Network (SBN). Si la aplicación host admite monikers, también puede crear una instancia de un componente de secuencia de comandos sin registrarlo.

Al especificar el registro, la información más importante es:

Un Id. de programa, que es el nombre que se utiliza en la aplicación host cuando se crea una instancia del componente de secuencia de comandos. Por ejemplo, si el Id. de programa del componente de secuencia de comandos es Componente.MiComponente, puede crear una instancia de él en Microsoft® Visual Basic® con una instrucción como la siguiente:
```
Set Component = CreateObject("Componente.MiComponente")
```
Un Id. de clase, que es un GUID (identificador exclusivo global), que identifique de forma exclusiva el componente de secuencia de comandos. Puede generar un GUID con un programa como Uuidgen.exe.
Nota Si crea un componente de secuencia de comandos con el Asistente para componentes de secuencia de comandos, el asistente genera automáticamente un Id. de programa y un Id. de clase. Para obtener más información, consulte Utilizar el Asistente para componentes de secuencia de comandos.

La información de registro también incluye una descripción y un número de versión.

El programa de registro puede crear un Id. de clase para el componente de secuencia de comandos cuando se registre. Sin embargo, es muy recomendable que proporcione un Id. de clase para el componente de secuencia de comandos, a fin de asegurar que tenga el mismo Id. de clase en todos los equipos en los que se registre. Si permite que el programa de registro cree un Id. de clase, también es posible que aparezcan problemas si utiliza el componente de secuencia de comandos con herramientas de desarrollo que almacenen identificadores de clase. Si durante el proceso de registro se crea un nuevo Id. de clase cada vez, éste no coincidirá con el Id. almacenado por la aplicación.

Para crear información de registro del componente de secuencia de comandos

Cree un elemento <registration> que incluya al menos un Id. de programa y, opcionalmente, un Id. de clase, descripción y versión, según se muestra en el ejemplo siguiente:
```
<registration
description="Mi componente de prueba"
progid="Componente de secuencia de comandos.ScriptPrueba"
version="1"
classid="{2154c700-9253-11d1-a3ac-0aa0044eb5f}"/>
```
Nota Los atributos de registro pueden aparecer en cualquier orden en el elemento <registration>.

Ejecutar una secuencia de comandos durante el registro

El elemento <registration> del componente de secuencia de comandos también permite incluir una secuencia de comandos que se ejecutará cuando se registre y se elimine del Registro. Por ejemplo, puede enviar un mensaje que indique que el componente de secuencia de comandos se ha registrado.

Para ejecutar una secuencia de comandos durante el registro y la eliminación del Registro

En el elemento <registration>, incluya un elemento <script>. Para ejecutar una secuencia de comandos durante el registro, escriba una función register( ). Para ejecutar una secuencia de comandos cuando el componente de secuencia de comandos se haya eliminado del Registro, incluya una función unregister( ).
El ejemplo siguiente muestra cómo enviar mensajes cuando el componente de secuencia de comandos se registra o se elimina del Registro.
Nota 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.
```
<registration
   description="Mi componente de prueba"
   progid="Componente.ComponentePrueba"
   version="1"
   classid="{2154c700-9253-11d1-a3ac-0aa0044eb5f}">

   <script language="VBScript">
   <![CDATA[
      Function register()
         MsgBox "Se registró el componente 'Mi componente de prueba'."
      End Function
      Function unregister()
         MsgBox "No se registró el componente 'Mi componente de prueba'."
      End Function
   ]]>
   </script>
</registration>
```

Registrar para acceso remoto

Si distribuye el componente de secuencia de comandos en un entorno distribuido, puede especificar que se cree una instancia del componente de secuencia de comandos de forma remota. Por ejemplo, puede crear un componente de secuencia de comandos para que se ejecute en un servidor, pero que se llamará desde el código de un cliente. Esta situación se puede producir si los equipos cliente y servidor están correctamente configurados con DCOM, que proporciona mecanismos para pasar punteros de objetos del servidor al cliente.

Para registrar un componente de secuencia de comandos a fin de que se pueda tener acceso de forma remota

Incluya el atributo remotable en el elemento <registration>, tal como se muestra en el ejemplo siguiente:

<registration
   description="Mi componente de prueba"
   progid="Componente.PruebaComponente"
   version="1"
   classid="{2154c700-9253-11d1-a3ac-0aa0044eb5f}"
   remotable=true/>

Para obtener más información acerca de cómo crear instacias de un componente de secuencia de comandos de forma remota, consulte Utilizar un componente de secuencia de comandos en una aplicación.

Consulte también

Contenido de los archivos de componentes de secuencia de comandos | Utilizar el Asistente para componentes de secuencia de comandos | Crear una biblioteca de tipos de Script Component | Comprobar errores en archivos de Script Component | Archivos de componentes de secuencia de comandos y compatibilidad XML