Load-Methode

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

Beschreibung

Lädt ein Zeichen in die Characters -Auflistung.

Syntax

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

Teil	Beschreibung
CharacterID-	Erforderlich. Ein Zeichenfolgenwert, den Sie verwenden, um auf die zu ladenden Zeichendaten zu verweisen.
Provider-	Erforderlich. Ein Variant-Datentyp, der eine der folgenden Sein muss: Filespec Der lokale Dateispeicherort der Definitionsdatei des angegebenen Zeichens. URL Die HTTP-Adresse für die Definitionsdatei des Zeichens.

Bemerkungen

Sie können Zeichen aus dem Agent-Unterverzeichnis laden, indem Sie einen relativen Pfad angeben (einer, der keinen Doppelpunkt oder führende Schrägstriche enthält). Dadurch wird der Pfad mit dem Zeichenverzeichnis des Agents (im lokalisierten Windows\msagent-Verzeichnis) vorangestellt. Wenn Sie beispielsweise Folgendes angeben, würde Genie.acs aus dem Chars-Verzeichnis des Agents geladen:

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

Sie können auch Ihr eigenes Verzeichnis im Chars-Verzeichnis des Agents angeben.

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

Sie können das zurzeit als Standardzeichen des aktuellen Benutzers festgelegte Zeichen laden, indem Sie keinen Pfad als zweiten Parameter der Load-Methode einschließen.

   Agent.Character.Load "character"

Sie können dasselbe Zeichen (ein Zeichen mit derselben GUID) nicht mehrmals aus einer einzigen Instanz des Steuerelements laden. Ebenso können Sie das Standardzeichen und andere Zeichen nicht gleichzeitig aus einer einzigen Instanz des Steuerelements laden, da das Standardzeichen mit dem anderen Zeichen identisch sein könnte. Wenn Sie versuchen, dies zu tun, löst der Server einen Fehler aus. Sie können jedoch eine andere Instanz des Agent-Steuerelements erstellen und dasselbe Zeichen laden.

Der Microsoft Agent-Datenanbieter unterstützt das Laden von Zeichendaten, die entweder als einzelne strukturierte Datei gespeichert sind (. ACS) mit Zeichendaten und Animationsdaten zusammen oder als separate Zeichendaten (. ACF) und Animation (. ACA) Dateien. Verwenden Sie die einzelnen strukturierten . ACS-Datei zum Laden eines Zeichens, das auf einem lokalen Datenträger oder Netzwerk gespeichert ist und über ein herkömmliches Dateiprotokoll (z. B. UNC-Pfadnamen) aufgerufen wird. Verwenden Sie die separate . ACF und . ACA-Dateien, wenn Sie die Animationsdateien einzeln von einem Remotestandort laden möchten, auf den sie mithilfe des HTTP-Protokolls zugegriffen werden.

Für. ACS-Dateien mit der Load-Methode bieten Zugriff auf die Animationen eines Zeichens. Für. ACF-Dateien verwenden Sie auch die Get-Methode zum Laden von Animationsdaten. Die Load-Methode unterstützt das Herunterladen nicht. ACS-Dateien von einer HTTP-Website.

Beim Laden eines Zeichens wird das Zeichen nicht automatisch angezeigt. Verwenden Sie zuerst die Show-Methode, um das Zeichen sichtbar zu machen.

Wenn Sie die methode Load verwenden, um eine zeichendatei zu laden, die auf dem lokalen Computer gespeichert ist und der Aufruf fehlschlägt; Da die Datei beispielsweise nicht gefunden wird, löst der Agent einen Fehler aus. Sie können die Unterstützung in Ihrer Programmiersprache verwenden, um eine Fehlerbehandlungsroutine bereitzustellen, um den Fehler zu erfassen und zu verarbeiten.

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

Sie können den Fehler auch behandeln, indem Sie RaiseRequestErrors- auf False-festlegen, ein Objekt deklarieren und ihm die Load Anforderung zuweisen. Folgen Sie dann dem Aufruf Load mit einer Anweisung, die den Status des Request-Objekts überprüft.

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

Wenn Sie ein Zeichen laden, das nicht lokal ist; Beispielsweise können Sie mithilfe des HTTP-Protokolls nach einem Load--Fehler suchen, indem Sie der Load-Methode ein Request-Objekt zuweisen. Da diese Methode zum Laden eines Zeichens jedoch asynchron behandelt wird, überprüfen Sie den Status im RequestComplete--Ereignis. Dieses Verfahren funktioniert nicht beim Laden eines Zeichens mithilfe des UNC-Protokolls, da die Load-Methode synchron verarbeitet wird.