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 de

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

sintaxis

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

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

Observaciones

Puede cargar caracteres desde el subdirectorio Agente 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 (ubicado en el directorio localizado windows\msagent). Por ejemplo, especificar lo siguiente 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 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. 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 del Agente de Microsoft 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 (. Archivos ACA. 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 desea 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.

Cargar 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 en 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 de carga de. A continuación, siga la llamada Load con una instrucción que compruebe el estado del objeto requestde.

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 Load mediante la asignación de un objeto Requestdeal método load de. 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.