Метод Load

[Microsoft Agent не рекомендуется использовать в Windows 7 и может быть недоступно в последующих версиях Windows.]

описание

Загружает символ в коллекцию символов.

синтаксис

агент**. Characters.Load "CharacterID",** поставщика

Часть	Описание
CharacterID	Обязательно. Строковое значение, которое будет использоваться для ссылки на данные символов, которые нужно загрузить.
поставщика	Обязательно. Тип данных variant, который должен быть одним из следующих типов: Filespec Локальное расположение файла определения указанного символа. URL-адрес HTTP-адрес для файла определения символа.

Замечания

Вы можете загрузить символы из подкаталога агента, указав относительный путь (один из которых не содержит двоеточие или символ косой черты). Это префиксирует путь с каталогом символов агента (расположен в локализованном каталоге Windows\msagent). Например, указывая следующее, загрузит Genie.acs из каталога Chars агента:

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

Вы также можете указать собственный каталог в каталоге Chars агента.

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

Символ по умолчанию можно загрузить в качестве символа по умолчанию текущего пользователя, не включая путь в качестве второго параметра метода Load.

   Agent.Character.Load "character"

Не удается загрузить один и тот же символ (символ с одним идентификатором GUID) несколько раз из одного экземпляра элемента управления. Аналогичным образом нельзя загружать символ по умолчанию и другие символы одновременно из одного экземпляра элемента управления, так как символ по умолчанию может совпадать с другим символом. При попытке сделать это сервер вызывает ошибку. Однако можно создать другой экземпляр элемента управления агентом и загрузить тот же символ.

Поставщик данных Microsoft Agent поддерживает загрузку символьных данных, хранящихся в виде одного структурированного файла (. ACS) с символьными данными и данными анимации вместе или как отдельные символьные (). ACF) и анимация (. Файлы ACA). Используйте один структурированный объект. ACS-файл для загрузки символа, хранящегося на локальном диске или в сети, и к нему осуществляется доступ с помощью обычного протокола файлов (например, UNC pathnames). Используйте отдельный. ACF и . ACA-файлы, когда требуется загрузить файлы анимации отдельно с удаленного сайта, к которому они обращаются с помощью протокола HTTP.

Для. Файлы ACS с помощью метода load Load предоставляют доступ к анимациям символа. Для. Файлы ACF также используют метод Get для загрузки данных анимации. Метод Load не поддерживает загрузку. Файлы ACS с HTTP-сайта.

Загрузка символа не отображается автоматически. Сначала используйте метод Show, чтобы сделать символ видимым.

Если вы используете метод Load для загрузки символьного файла, хранящегося на локальном компьютере, и вызов завершается ошибкой; Например, так как файл не найден, агент вызывает ошибку. Вы можете использовать поддержку на языке программирования, чтобы предоставить подпрограмму обработки ошибок для перехвата и обработки ошибки.

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

Вы также можете обработать ошибку, задав RaiseRequestErrors значение False, объявление объекта и назначение запроса Load. Затем выполните вызов Load с инструкцией, которая проверяет состояние объектазапроса.

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

Если вы загружаете символ, который не является локальным; Например, с помощью протокола HTTP можно также проверить наличие сбоя load, назначив объектзапросаметод у load load. Однако, так как этот метод загрузки символа обрабатывается асинхронно, проверьте его состояние в событииRequestComplete. Этот метод не будет работать с загрузкой символа с помощью протокола UNC, так как метод load обрабатывается синхронно.