Load, metoda

[Program Microsoft Agent jest przestarzały w systemie Windows 7 i może być niedostępny w kolejnych wersjach systemu Windows.

opis

Ładuje znak do kolekcji Znaki.

składni

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

Część	Opis
CharacterID	Wymagane. Wartość ciągu, która będzie używana do odwoływania się do danych znaków do załadowania.
dostawcy	Wymagane. Typ danych wariantu, który musi być jednym z następujących: Filespec Lokalizacja pliku lokalnego pliku definicji określonego znaku. adres URL adres HTTP dla pliku definicji znaku.

Uwagi

Znaki można załadować z podkatalogu Agent, określając ścieżkę względną (nie zawierającą dwukropka lub wiodącego znaku ukośnika). To prefiksy ścieżki z katalogiem znaków agenta (znajdującym się w zlokalizowanym katalogu Windows\msagent). Na przykład określenie następującego polecenia spowoduje załadowanie pliku Genie.acs z katalogu Chars agenta:

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

Możesz również określić własny katalog w katalogu Chars agenta.

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

Znak aktualnie ustawiany jako domyślny znak bieżącego użytkownika można załadować, nie dołączając ścieżki jako drugiego parametru metody Load.

   Agent.Character.Load "character"

Nie można załadować tego samego znaku (znaku o tym samym identyfikatorze GUID) więcej niż raz z jednego wystąpienia kontrolki. Podobnie nie można załadować domyślnego znaku i innych znaków w tym samym czasie z pojedynczego wystąpienia kontrolki, ponieważ znak domyślny może być taki sam jak inny znak. Jeśli spróbujesz to zrobić, serwer zgłosi błąd. Można jednak utworzyć inne wystąpienie kontrolki Agent i załadować ten sam znak.

Dostawca danych programu Microsoft Agent obsługuje ładowanie danych znaków przechowywanych jako pojedynczy plik ustrukturyzowany (. ACS) z danymi znaków i danymi animacji razem lub jako oddzielne dane znaków (. ACF) i animacja (. Pliki ACA). Użyj pojedynczej struktury . Plik ACS w celu załadowania znaku przechowywanego na dysku lokalnym lub sieci i uzyskiwania dostępu przy użyciu konwencjonalnego protokołu plików (takiego jak nazwy ścieżek UNC). Użyj oddzielnego . ACF i . Pliki ACA, gdy chcesz załadować pliki animacji indywidualnie z lokacji zdalnej, do której uzyskuje się dostęp przy użyciu protokołu HTTP.

Dla. Pliki ACS przy użyciu metody Load zapewniają dostęp do animacji znaku. Dla. Pliki ACF umożliwiają również ładowanie danych animacji za pomocą metody Get. Metoda Load nie obsługuje pobierania pliku . Pliki ACS z witryny HTTP.

Ładowanie znaku nie powoduje automatycznego wyświetlenia znaku. Użyj najpierw metody Show, aby uwidocznić znak.

Jeśli używasz metody Load w celu załadowania pliku znaku przechowywanego na komputerze lokalnym i wywołanie zakończy się niepowodzeniem; na przykład, ponieważ plik nie został znaleziony, agent zgłasza błąd. Możesz użyć obsługi w języku programowania, aby zapewnić procedurę obsługi błędów w celu przechwycenia i przetworzenia błędu.

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

Błąd można również obsłużyć, ustawiając RaiseRequestErrors na false, deklarując obiekt i przypisując do niego żądanie Load. Następnie postępuj zgodnie z wywołaniem Load z instrukcją, która sprawdza stan obiektużądania.

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

W przypadku załadowania znaku, który nie jest lokalny; Na przykład przy użyciu protokołu HTTP można również sprawdzić błąd ładowania , przypisując obiekt Request do metody Load. Jednak ponieważ ta metoda ładowania znaku jest obsługiwana asynchronicznie, sprawdź jego stan w zdarzeniu RequestComplete. Ta technika nie będzie działać podczas ładowania znaku przy użyciu protokołu UNC, ponieważ metoda Load jest przetwarzana synchronicznie.