Load, metodo

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

Descrizione

Carica un carattere nell'insieme Characters.

sintassi

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

Parte	Descrizione
CharacterID	Obbligatorio. Valore stringa che verrà usato per fare riferimento ai dati di tipo carattere da caricare.
provider	Obbligatorio. Tipo di dati variant che deve essere uno dei seguenti: Filespec Percorso file locale del file di definizione del carattere specificato. URL L'indirizzo HTTP per il file di definizione del carattere.

Osservazioni

È possibile caricare i caratteri dalla sottodirectory Agent specificando un percorso relativo (uno che non include due punti o un carattere barra iniziale). Questo prefissi il percorso con la directory dei caratteri dell'agente ,che si trova nella directory windows\msagent localizzata. Ad esempio, se si specifica quanto segue, verrà caricato Genie.acs dalla directory Chars dell'agente:

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

È anche possibile specificare la propria directory nella directory Chars di Agent.

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

È possibile caricare il carattere attualmente impostato come carattere predefinito dell'utente corrente senza includere un percorso come secondo parametro del metodo Load.

   Agent.Character.Load "character"

Non è possibile caricare lo stesso carattere (un carattere con lo stesso GUID) più volte da una singola istanza del controllo. Analogamente, non è possibile caricare il carattere predefinito e altri caratteri contemporaneamente da una singola istanza del controllo perché il carattere predefinito potrebbe essere uguale all'altro carattere. Se si tenta di eseguire questa operazione, il server genera un errore. Tuttavia, è possibile creare un'altra istanza del controllo Agent e caricare lo stesso carattere.

Il provider di dati di Microsoft Agent supporta il caricamento di dati di tipo carattere archiviati come singolo file strutturato (. ACS) con dati di tipo carattere e dati di animazione insieme o come dati di tipo carattere separati (. ACF) e animazione (. File ACA). Usare il singolo oggetto strutturato. File ACS per caricare un carattere archiviato in un disco locale o in una rete e a cui si accede usando un protocollo di file convenzionale (ad esempio i nomi di percorso UNC). Usare l'oggetto separato. ACF e . File ACA quando si desidera caricare i file di animazione singolarmente da un sito remoto a cui si accede usando il protocollo HTTP.

Per. I file ACS, usando il metodo Load consentono di accedere alle animazioni di un carattere. Per. I file ACF usano anche il metodo getper caricare i dati di animazione. Il metodo Load non supporta il download di . File ACS da un sito HTTP.

Il caricamento di un carattere non visualizza automaticamente il carattere. Usare prima il metodo showper rendere visibile il carattere.

Se si usa il metodo Load per caricare un file di caratteri archiviato nel computer locale e la chiamata ha esito negativo; Ad esempio, poiché il file non viene trovato, Agent genera un errore. È possibile usare il supporto nel linguaggio di programmazione per fornire una routine di gestione degli errori per intercettare ed elaborare l'errore.

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

È anche possibile gestire l'errore impostando RaiseRequestErrors su False, dichiarando un oggetto e assegnando la richiesta load. Seguire quindi la chiamata load con un'istruzione che controlla lo stato dell'oggettoRequest.

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

Se si carica un carattere non locale; Ad esempio, usando il protocollo HTTP, è anche possibile verificare la presenza di un errore Load assegnando un oggettorichiesta dial metodo Load. Tuttavia, poiché questo metodo di caricamento di un carattere viene gestito in modo asincrono, controllarne lo stato nell'eventoRequestComplete. Questa tecnica non funzionerà il caricamento di un carattere usando il protocollo UNC perché il metodo load viene elaborato in modo sincrono.