Load (Método)

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows.

Descripción

Carga un carácter en la colección Characters .

Syntax

agent**. Characters.Load "CharacterID",** Provider

Parte	Descripción
CharacterID	Necesario. Valor de cadena que usará para hacer referencia a los datos de caracteres que se van a cargar.
Proveedor	Necesario. Tipo de datos variant que debe ser uno de los siguientes: Filespec La ubicación del archivo de definición del carácter especificado. URL Dirección HTTP del archivo de definición del carácter.

Observaciones

Puede cargar caracteres desde el subdirectorio Agent especificando una ruta de acceso relativa (una que no incluye un carácter de dos puntos o barra diagonal inicial). Este prefijo la ruta de acceso con el directorio de caracteres del Agente (que se encuentra en el directorio Windows\msagent localizado). Por ejemplo, al especificar lo siguiente se cargaría Genie.acs desde el directorio Chars del agente:

   Agent.Character.Load "genie", "genie.acs"

También puede especificar su propio directorio en el directorio chars del agente.

   Agent.Character.Load "genie", "MyCharacters\genie.acs"

Puede cargar el carácter establecido actualmente como carácter predeterminado del usuario actual si no incluye una ruta de acceso como el segundo parámetro del método Load .

   Agent.Character.Load "character"

No se puede cargar el mismo carácter (un carácter que tenga el mismo GUID) más de una vez desde una sola instancia del control. Del mismo modo, no se puede cargar el carácter predeterminado y otros caracteres al mismo tiempo desde una sola instancia del control porque el carácter predeterminado podría ser el mismo que el otro carácter. Si intenta hacerlo, el servidor genera un error. Sin embargo, puede crear otra instancia del control Agente y cargar el mismo carácter.

El proveedor de datos de Microsoft Agent admite la carga de datos de caracteres almacenados como un único archivo estructurado (. ACS) con datos de caracteres y datos de animación juntos o como datos de caracteres independientes (. ACF) y animación (. ACA) archivos. Use el único estructurado. Archivo ACS para cargar un carácter almacenado en un disco o red local y al que se accede mediante un protocolo de archivo convencional (como nombres de ruta de acceso UNC). Use la propiedad independiente . ACF y . Archivos ACA cuando quiera cargar los archivos de animación individualmente desde un sitio remoto al que se accede mediante el protocolo HTTP.

Para. Los archivos ACS, mediante el método Load proporcionan acceso a las animaciones de un carácter. Para. Los archivos ACF también se usan el método Get para cargar datos de animación. El método Load no admite la descarga de . Archivos ACS de un sitio HTTP.

La carga de un carácter no muestra automáticamente el carácter. Use primero el método Show para que el carácter sea visible.

Si usa el método Load para cargar un archivo de caracteres almacenado en el equipo local y se produce un error en la llamada; Por ejemplo, dado que no se encuentra el archivo, el Agente genera un error. Puede usar la compatibilidad con el lenguaje de programación para proporcionar una rutina de control de errores para detectar y procesar el error.

   Sub Form_Load
      On Error GoTo ErrorHandler
      Agent1.Characters.Load "mychar", "genie.acs"
      ' Successful load
      . . .
      Exit Sub
      ErrorHandler:
      ' Unsuccessful load
      . . .
      Resume Next
   End Sub

También puede controlar el error estableciendo RaiseRequestErrors en False, declarando un objeto y asignando la solicitud load a él. A continuación, siga la llamada Load con una instrucción que compruebe el estado del objeto Request .

Dim LoadRequest as Object

   Sub Form_Load
      Agent1.RaiseRequestErrors = False
      Set LoadRequest = Agent1.Characters.Load _
         ("mychar", "c:\some directory\some character.acs")
      If LoadRequest.Status Not 0 Then
         ' Unsuccessful load
         . . .
         Exit Sub
      Else 
         ' Successful load
         . . .
   End Sub

Si carga un carácter que no es local; por ejemplo, mediante el protocolo HTTP, también puede comprobar si hay un error de carga mediante la asignación de un objeto Request al método Load . Sin embargo, dado que este método de carga de un carácter se controla de forma asincrónica, compruebe su estado en el evento RequestComplete . Esta técnica no funcionará cargando un carácter mediante el protocolo UNC porque el método Load se procesa de forma sincrónica.