Recupera un objeto existente, al que corresponde el IdProg especificado, o crea uno nuevo a partir de un archivo.

objeto.GetObject(cdnNombreruta [,cdnIdProg], [cdnPrefijo])

Argumentos

objeto

Objeto WScript.

cdnNombreruta

El nombre de la ruta completa del archivo que contiene el objeto almacenado en disco.

cdnIdProg

Opcional. El identificador de programa del objeto (IdProg).

cdnPrefijo

Opcional. Se utiliza para sincronizar los eventos de un objeto. Si incluye el argumento cdnPrefijo, Windows Script Host, después de crear el objeto, conecta la interfaz saliente del mismo con el archivo de comandos.

Comentarios

Utilice el método GetObject si ya existe una instancia del objeto en la memoria o si desea crear el objeto a partir de un archivo. Si no existe ninguna instancia y no desea que el objeto se cree desde un archivo, utilice el método CreateObject. El método GetObject funciona con todas las clases COM, independiente del lenguaje utilizado para crear el objeto. Si incluye el argumento cdnPrefijo, Windows Script Host, después de crear el objeto, conecta la interfaz saliente del mismo con el archivo de comandos. Cuando el objeto desencadena un evento, Windows Script Host llama a una subrutina cuyo nombre conste de cdnPrefijo y el nombre del evento. Por ejemplo, si cdnPrefijo es MIOBJ_ y el objeto desencadena un evento llamado alInicio, Windows Script Host llama a la subrutina MIOBJ_alInicio que se encuentre en la secuencia de comandos.

Si un objeto está registrado como de una única instancia, sólo se crea una instancia, independientemente del número de veces que se ejecute GetObject. Además el método GetObject siempre devuelve la misma instancia cuando se le llama con la sintaxis de cadena de longitud cero ("") y produce un error si se omite el parámetro de ruta. No se puede utilizar el método GetObject para obtener una referencia a una clase de Microsoft Visual Basic creada con Visual Basic 4.0 o anterior.

Ejemplo

El siguiente código de VBScript inicia la aplicación asociada con el archivo especificado (cdnNombreRuta):

Dim MiObjeto As Object
Set MiObjeto = GetObject("C:\CAD\ESQUEMA.CAD")
MiApl = MiObjeto.Application

Algunas aplicaciones permiten activar parte del archivo. Para hacerlo, agregue un signo de exclamación (!) al final del nombre del archivo e incluya a continuación una cadena que identifique la parte del archivo que desee activar. Por ejemplo, en una aplicación de dibujo, un dibujo almacenado en un archivo podría tener múltiples capas. El siguiente código activa una capa de un archivo de dibujo llamado ESQUEMA.CAD:

Set ObjetoCapa = GetObject("C:\CAD\ESQUEMA.CAD!Layer3")

Si no especifica la clase del objeto (cdnIdProg), COM determina que la aplicación se iniciará a partir del nombre de archivo. Algunos archivos pueden admitir más de una clase de objeto. Por ejemplo, un dibujo podría admitir tres tipos diferentes de objetos: un objeto de aplicación, un objeto de dibujo y un objeto de barra de herramientas. Todos ellos pueden formar parte del mismo archivo.

En el siguiente código de VBScript se inicia la aplicación de dibujo INVENTO y se abre el objeto DIBUJO del archivo EJEMPLO.DRW.

Dim MiObjeto As Object
Set MiObjeto = GetObject("C:\DIBUJOS\EJEMPLO.DRW", "INVENTO.DRAWING")

Consulte también

Objeto WScript | Método CreateObject| Método DisconnectObject