Load-Methode

[Microsoft Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

Beschreibung

Lädt ein Zeichen in die Characters-Auflistung .

Syntax

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

Teil	BESCHREIBUNG
CharacterID	Erforderlich. Ein Zeichenfolgenwert, den Sie verwenden, um auf die zu ladenden Zeichendaten zu verweisen.
Anbieter	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 Unterverzeichnis Agent laden, indem Sie einen relativen Pfad angeben (der keinen Doppelpunkt oder führenden Schrägstrich enthält). Dadurch wird dem Pfad das Zeichenverzeichnis des Agents vorangestellt (im lokalisierten Verzeichnis Windows\msagent). Wenn Sie beispielsweise Folgendes angeben, wird Genie.acs aus dem Verzeichnis Chars des Agents geladen:

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

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

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

Sie können das Zeichen laden, das derzeit als Standardzeichen des aktuellen Benutzers festgelegt ist, indem Sie keinen Pfad als zweiten Parameter der Load-Methode angeben.

   Agent.Character.Load "character"

Sie können dasselbe Zeichen (ein Zeichen mit derselben GUID) nicht mehr als einmal aus einem einzelnen instance des Steuerelements laden. Ebenso können Sie das Standardzeichen und andere Zeichen nicht gleichzeitig aus einer einzelnen instance des Steuerelements laden, da das Standardzeichen mit dem anderen Zeichen identisch sein könnte. Wenn Sie dies versuchen, löst der Server einen Fehler aus. Sie können jedoch eine weitere instance des Agent-Steuerelements erstellen und dasselbe Zeichen laden.

Der Microsoft Agent-Datenanbieter unterstützt das Laden von Zeichendaten, die entweder als einzelne strukturierte Datei (. ACS) mit Zeichen- und Animationsdaten zusammen oder als separate Zeichendaten (. ACF) und Animation (. ACA)-Dateien. Verwenden Sie die einzelne strukturierte . ACS-Datei zum Laden eines Zeichens, das auf einem lokalen Datenträger oder Netzwerk gespeichert ist und auf das mithilfe eines herkömmlichen Dateiprotokolls (z. B. UNC-Pfadnamen) zugegriffen wird. Verwenden Sie das separate . ACF und . ACA-Dateien, wenn Sie die Animationsdateien einzeln von einer Remotewebsite laden möchten, auf die mithilfe des HTTP-Protokolls zugegriffen wird.

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 , um Animationsdaten zu laden. Das Herunterladen von wird von der Load-Methode nicht unterstützt. 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 Load-Methode 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 zum Abfangen und Verarbeiten des Fehlers bereitzustellen.

   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 Load-Aufruf mit einer Anweisung, die die 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 auch überprüfen, ob ein Load-Fehler auftritt, indem Sie der Load-Methode ein Request-Objekt zuweisen. Da diese Methode zum Laden eines Zeichens jedoch asynchron behandelt wird, überprüfen Sie dessen status im RequestComplete-Ereignis. Dieses Verfahren funktioniert nicht beim Laden eines Zeichens mithilfe des UNC-Protokolls, da die Load-Methode synchron verarbeitet wird.