Laadmethode

[Microsoft Agent is afgeschaft vanaf Windows 7 en is mogelijk niet beschikbaar in volgende versies van Windows.]

beschrijving

Laadt een teken in de verzameling Tekens.

syntaxis

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

Deel	Beschrijving
CharacterID-	Vereist. Een tekenreekswaarde die u gaat gebruiken om te verwijzen naar de tekengegevens die moeten worden geladen.
Provider-	Vereist. Een variantgegevenstype dat een van de volgende moet zijn: Filespec De locatie van het lokale bestand van het opgegeven definitiebestand van het opgegeven teken. URL het HTTP-adres voor het definitiebestand van het teken.

Opmerkingen

U kunt tekens uit de submap Agent laden door een relatief pad op te geven (een pad dat geen dubbele punt of schuine streep bevat). Hiermee wordt het pad voorafgegaan door de map met tekens van de agent (in de gelokaliseerde map Windows\msagent). Als u bijvoorbeeld het volgende opgeeft, wordt Genie.acs uit de map Chars van agent geladen:

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

U kunt ook uw eigen map opgeven in de map Chars van de agent.

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

U kunt het teken dat momenteel is ingesteld, laden als het standaardteken van de huidige gebruiker door geen pad op te maken als de tweede parameter van de methode Laden.

   Agent.Character.Load "character"

U kunt hetzelfde teken (een teken met dezelfde GUID) niet meer dan één keer laden vanuit één exemplaar van het besturingselement. Op dezelfde manier kunt u het standaardteken en andere tekens niet tegelijkertijd laden vanuit één exemplaar van het besturingselement, omdat het standaardteken hetzelfde kan zijn als het andere teken. Als u dit probeert te doen, genereert de server een fout. U kunt echter een ander exemplaar van het besturingselement Agent maken en hetzelfde teken laden.

De Microsoft Agent-gegevensprovider ondersteunt het laden van tekengegevens die zijn opgeslagen als één gestructureerd bestand (. ACS) met tekengegevens en animatiegegevens samen of als afzonderlijke tekengegevens (. ACF) en animatie (. ACA)-bestanden. Gebruik de individuele gestructureerde . ACS-bestand voor het laden van een teken dat is opgeslagen op een lokale schijf of netwerk en die wordt geopend met behulp van een conventioneel bestandsprotocol (zoals UNC-padnamen). Gebruik de afzonderlijke . ACF en . ACA-bestanden wanneer u de animatiebestanden afzonderlijk wilt laden vanaf een externe site waar ze worden geopend met behulp van het HTTP-protocol.

Voor. ACS-bestanden met behulp van de methode Laden biedt toegang tot animaties van een teken. Voor. ACF-bestanden gebruikt u ook de methode Get om animatiegegevens te laden. De methode Laden biedt geen ondersteuning voor downloaden. ACS-bestanden van een HTTP-site.

Als u een teken laadt, wordt het teken niet automatisch weergegeven. Gebruik eerst de methode weergeven om het teken zichtbaar te maken.

Als u de methode Laden gebruikt om een tekenbestand te laden dat is opgeslagen op de lokale computer en de aanroep mislukt; Omdat het bestand bijvoorbeeld niet wordt gevonden, genereert agent een fout. U kunt de ondersteuning in uw programmeertaal gebruiken om een foutafhandelingsroutine te bieden om de fout te ondervangen en te verwerken.

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

U kunt de fout ook afhandelen door RaiseRequestErrors- in te stellen op Onwaar, een object te declareren en de -aanvraag toe te wijzen. Volg vervolgens de aanroep Laden met een instructie waarmee de status van het Aanvraag--object wordt gecontroleerd.

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

Als u een teken laadt dat niet lokaal is; Met behulp van het HTTP-protocol kunt u bijvoorbeeld ook controleren op een fout in Laden door een Aanvraag--object toe te wijzen aan de methode Laden. Omdat deze methode voor het laden van een teken echter asynchroon wordt verwerkt, controleert u de status ervan in de gebeurtenis RequestComplete. Deze techniek werkt niet bij het laden van een teken met behulp van het UNC-protocol, omdat de methode laden synchroon wordt verwerkt.