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

Élément	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 suivants : Filespec Emplacement de fichier local du fichier de définition du caractère spécifié. URL Adresse HTTP du fichier de définition du caractère.

Notes

Vous pouvez charger des caractères à partir du sous-répertoire Agent en spécifiant un chemin d’accès relatif (qui n’inclut pas de deux-points ou de barre oblique de début). Cela préfixe le chemin d’accès avec le répertoire de 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 le structuré 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, les noms de chemin d’accès UNC). Utilisez le distinct . ACF et . Fichiers ACA lorsque vous souhaitez charger les fichiers d’animation individuellement à partir d’un site distant où ils sont accessibles à l’aide du protocole HTTP.

Pour. Les fichiers ACS, à l’aide de la méthode Load , permettent d’accéder aux animations d’un caractère. Pour. Dans les fichiers ACF, vous utilisez également 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 de caractères stocké sur l’ordinateur local et que l’appel échoue ; par exemple, étant donné que le fichier est introuvable, l’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 permettant d’intercepter et de 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 False, en déclarant un objet et en lui attribuant la demande de chargement . Suivez ensuite l’appel de charge avec une instruction qui vérifie la status 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 case activée en cas d’échec de chargement 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, case activée son status dans l’événement RequestComplete. Cette technique ne fonctionnera pas pour charger un caractère à l’aide du protocole UNC, car la méthode Load est traitée de manière synchrone.