Load – metoda

[Microsoft Agent je zastaralý jako Windows 7 a může být nedostupný v následujících verzích Windows.]

popis

Načte znak do kolekce Znaků.

syntaxe

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

Část	Popis
characterID	Požadovaný. Řetězcová hodnota, kterou použijete k odkazování na data znaků, která se mají načíst.
poskytovatele	Požadovaný. Datový typ varianty, který musí být jeden z následujících: Filespec umístění místního souboru definice znaku. adresa URL adresa HTTP definičního souboru znaku.

Poznámky

Znaky z podadresáře Agent můžete načíst zadáním relativní cesty (která neobsahuje dvojtečku nebo počáteční znak lomítka). Tím se předpona cesty k adresáři znaků agenta (nachází se v lokalizované adresáři Windows\msagent). Zadáním následujícího příkazu se například načte Genie.acs z adresáře Chars agenta:

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

Můžete také zadat vlastní adresář v adresáři Chars agenta.

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

Znak, který je aktuálně nastaven jako výchozí znak aktuálního uživatele, můžete načíst tak, že jako druhý parametr metody Load nezadáte cestu.

   Agent.Character.Load "character"

Z jedné instance ovládacího prvku nelze načíst stejný znak (znak se stejným identifikátorem GUID) více než jednou. Podobně nelze načíst výchozí znak a další znaky současně z jedné instance ovládacího prvku, protože výchozí znak může být stejný jako druhý znak. Pokud se to pokusíte provést, server vyvolá chybu. Můžete však vytvořit další instanci ovládacího prvku Agent a načíst stejný znak.

Zprostředkovatel dat microsoft agenta podporuje načítání znakových dat uložených buď jako jeden strukturovaný soubor (. ACS) se znakovými daty a animačními daty společně nebo jako samostatná data znaků (. ACF) a animace (. ACA) soubory. Použijte jednu strukturovanou . Soubor ACS k načtení znaku uloženého na místním disku nebo síti a přístupu pomocí konvenčního souborového protokolu (například názvu cesty UNC). Použijte samostatný . ACF a . Soubory ACA, pokud chcete načíst animační soubory jednotlivě ze vzdáleného webu, kde se k nim přistupuje pomocí protokolu HTTP.

Pro. Soubory ACS pomocí metody Load poskytuje přístup k animacím znaků. Pro. Soubory ACF také použijete metodu Get k načtení animačních dat. Metoda Load nepodporuje stahování . Soubory služby ACS z webu HTTP.

Načtení znaku automaticky nezobrazuje. Nejprve použijte metodu Show, aby byl znak viditelný.

Pokud použijete metodu Load k načtení souboru znaků uloženého na místním počítači a volání selže; Protože například soubor nebyl nalezen, agent vyvolá chybu. Pomocí podpory v programovacím jazyce můžete poskytnout rutinu zpracování chyb pro zachycení a zpracování chyby.

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

Chybu můžete také zpracovat nastavením RaiseRequestErrors na false, deklarováním objektu a přiřazením požadavku Load k ní. Potom postupujte podle volání Load příkazem, který zkontroluje stav objektu 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

Pokud načtete znak, který není místní; Například pomocí protokolu HTTP můžete také zkontrolovat selhání načtení přiřazením objektu Request metodě Load. Vzhledem k tomu, že se tato metoda načítání znaku zpracovává asynchronně, zkontrolujte její stav v události RequestComplete. Tato technika nebude fungovat načítání znaku pomocí protokolu UNC, protože metoda Load je zpracována synchronně.