Windows Script Components  

Elemento <reference>

Incluye una referencia a una biblioteca de tipos externa.

<reference [object="IdDePrograma" |guid="GUIDDeBibliotecaDeTipos"] [version="versión"]>

Argumentos

IdDePrograma
El Id. de programa a partir del cual se puede derivar la biblioteca de tipos, que cual puede incluir un número de versión (por ejemplo, ADO.Recordset.2.0). Puede incluir el Id. de programa explícito de una biblioteca de tipos o el Id. de programa del ejecutable (como un archivo .DLL) que incorpore la biblioteca de tipos. Si utiliza el atributo object, no necesita especificar un atributo version porque la versión se puede inferir del Id. de programa.

Si se especifica el atributo object, no se puede especificar un atributo guid.

GUIDDeBibliotecaDeTipos
El GUID de la biblioteca de tipos a la que se hace referencia. Si se especifica el atributo guid, no se puede especificar un atributo object.
versión
(Opcional) El número de versión de la biblioteca de tipos que se va a utilizar. Debe tener el formato <versión principal>[.<versión secundaria>]. Si no se especifica una versión, la versión predeterminada es 1.0. Si se utiliza el atributo object para especificar la biblioteca de tipos y no se especifica la versión, ésta se deriva de la clave del Registro del Id. de programa especificado. Si no se encuentra ninguna, el valor predeterminado es 1.0.

Observaciones

Hacer referencia a una biblioteca de tipos en el componente de secuencia de comandos permite utilizar constantes definidas en la biblioteca de tipos de las secuencias de comandos. El elemento <reference> busca y pone a disposición la biblioteca de tipos asociada con un Id. de programa específico o un nombre de biblioteca de tipos. La información de la biblioteca de tipos puede estar disponible en archivos .tlb, .olb o .dll.

El elemento <reference> debería aparecer dentro del elemento <component>. Si hay más de un componente de secuencia de comandos en el paquete, la biblioteca de tipos sólo se aplica al componente de secuencia de comandos en cuyo elemento <component> se declare.

Ejemplo

En el siguiente fragmento de componente de secuencia de comandos, la referencia a la biblioteca de tipos de ADO (que se encuentra en el archivo MSAD015.DLL) permite utilizar las constantes ADO, como adStateOpen, en las secuencias de comandos.

Nota   Es necesario incluir una sección CDATA para hacer opaca la secuencia de comandos del elemento <script>. Para obtener información, consulte Archivos de componentes de secuencia de comandos y compatibilidad XML.
<reference object="ADODB.Connection.2.0"/>
   <registration progid="ADOScriptlet"/>
<public>
   <property name="cnnstate"/>
   <method name="openConnection"/>
   <method name="closeConnection"/>
</public>

<script language="VBScript">
<![CDATA[
Dim cnn
Dim cnnState
Function openConnection()
   Set cnn = CreateObject("ADODB.Connection")
   cnn.ConnectionString = 
      "driver={SQL Server};server=miServidor;uid=sa;database=pubs"
   cnn.Open
   If cnn.State = adStateOpen Then
      cnnState = "abierta"
   Else
      cnnState = "cerrada"
   End If
End Function

Function closeConnection()
   cnn.Close
   cnnState = "cerrada"
End Function
]]>
</script>   

Consulte también

Hacer referencia a otros componentes

Ayuda de Javascript y Vbscript para Javascripts.astalaweb.com.