Load, méthode

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

Description

Charge un caractère dans la collection Characters.

syntaxe

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

Partie	Description
CharacterID	Obligatoire. Valeur de chaîne que vous utiliserez pour faire référence aux données de caractères à charger.
fournisseur	Obligatoire. Type de données variant qui doit être l’un des éléments suivants : Filespec L’emplacement de fichier local du fichier de définition du caractère spécifié. URL l’adresse HTTP du fichier de définition du caractère.

Remarques

Vous pouvez charger des caractères à partir du sous-répertoire Agent en spécifiant un chemin relatif (qui n’inclut pas de signe deux-points ou de barre oblique de début). Cela préfixe le chemin d’accès avec le répertoire des caractères de l’agent (situé dans le répertoire Windows\msagent localisé). Par exemple, si vous spécifiez ce qui suit, vous chargez Genie.acs à partir du répertoire Chars de l’agent :

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

Vous pouvez également spécifier votre propre répertoire dans le répertoire Chars de l’Agent.

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

Vous pouvez charger le caractère actuellement défini comme caractère par défaut de l’utilisateur actuel en n’incluant pas de chemin d’accès comme deuxième paramètre de la méthode Load.

   Agent.Character.Load "character"

Vous ne pouvez pas charger le même caractère (un caractère ayant le même GUID) plusieurs fois à partir d’une seule instance du contrôle. De même, vous ne pouvez pas charger le caractère par défaut et d’autres caractères en même temps à partir d’une seule instance du contrôle, car le caractère par défaut peut être identique à l’autre caractère. Si vous tentez de le faire, le serveur génère une erreur. Toutefois, vous pouvez créer une autre instance du contrôle Agent et charger le même caractère.

Le fournisseur de données Microsoft Agent prend en charge le chargement des données de caractères stockées sous la forme d’un seul fichier structuré (. ACS) avec des données de caractères et des données d’animation ensemble ou en tant que données de caractères distinctes (. ACF) et animation (. Fichiers ACA). Utilisez la structure unique . Fichier ACS pour charger un caractère stocké sur un disque ou un réseau local et accessible à l’aide d’un protocole de fichier conventionnel (par exemple, un nom de chemin d’accès UNC). Utilisez le fichier distinct . ACF et . Fichiers ACA lorsque vous souhaitez charger les fichiers d’animation individuellement à partir d’un site distant auquel ils sont accessibles à l’aide du protocole HTTP.

Pour. Les fichiers ACS, à l’aide de la méthode Load permet d’accéder aux animations d’un caractère. Pour. Les fichiers ACF vous permettent également d’utiliser la méthode Get pour charger des données d’animation. La méthode Load ne prend pas en charge le téléchargement. Fichiers ACS à partir d’un site HTTP.

Le chargement d’un caractère n’affiche pas automatiquement le caractère. Utilisez d’abord la méthode Show pour rendre le caractère visible.

Si vous utilisez la méthode Load pour charger un fichier caractère stocké sur l’ordinateur local et que l’appel échoue ; par exemple, étant donné que le fichier est introuvable, Agent génère une erreur. Vous pouvez utiliser la prise en charge dans votre langage de programmation pour fournir une routine de gestion des erreurs pour intercepter et traiter l’erreur.

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

Vous pouvez également gérer l’erreur en définissant RaiseRequestErrors sur faux, en déclarant un objet et en lui affectant la requête Load. Suivez ensuite l’appel Load avec une instruction qui vérifie l’état de l’objet 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 vous chargez un caractère qui n’est pas local ; Par exemple, à l’aide du protocole HTTP, vous pouvez également rechercher un échec Load en affectant un objet Request à la méthode Load. Toutefois, étant donné que cette méthode de chargement d’un caractère est gérée de manière asynchrone, vérifiez son état dans l’événement RequestComplete. Cette technique ne fonctionne pas au chargement d’un caractère à l’aide du protocole UNC, car la méthode Load est traitée de manière synchrone.