Load 方法

[从 Windows 7 开始，Microsoft代理已弃用，在后续版本的 Windows 中可能不可用。

说明

将字符加载到 字符 集合中。

语法

代理**。Characters.Load “CharacterID”，** 提供程序

部分	描述
CharacterID	必填。 一个字符串值，用于引用要加载的字符数据。
提供程序	必填。 一种变量数据类型，必须是下列类型之一：Filespec 指定字符定义文件的本地文件位置。 URL 字符定义文件的 HTTP 地址。

言论

可以通过指定相对路径（不包括冒号或前导斜杠字符）从代理子目录加载字符。 这会使用代理的字符目录（位于本地化的 Windows\msagent 目录中）作为路径的前缀。 例如，指定以下内容将从代理的 Chars 目录中加载 Genie.acs：

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

还可以在代理的 Chars 目录中指定自己的目录。

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

通过将路径作为 Load 方法的第二个参数，可以加载当前用户的默认字符。

   Agent.Character.Load "character"

不能从控件的单个实例多次加载同一个字符（具有相同 GUID 的字符）。 同样，不能同时从控件的单个实例加载默认字符和其他字符，因为默认字符可能与其他字符相同。 如果尝试执行此作，服务器将引发错误。 但是，可以创建代理控件的另一个实例并加载相同的字符。

Microsoft代理数据提供程序支持加载存储为单个结构化文件（） 的字符数据。ACS 包含字符数据和动画数据，或作为单独的字符数据（）。ACF） 和动画 （.ACA） 文件。 使用单个结构化 。ACS 文件用于加载存储在本地磁盘或网络上的字符，并使用常规文件协议（如 UNC 路径名）进行访问。 使用单独的 。ACF 和 .如果要从使用 HTTP 协议访问动画文件的远程站点单独加载动画文件，ACA 文件。

为。使用 Load 方法的 ACS 文件提供对字符动画的访问权限。 为。ACF 文件，还可以使用 Get 方法来加载动画数据。 Load 方法不支持下载。来自 HTTP 站点的 ACS 文件。

加载字符不会自动显示字符。 首先使用 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 方法来检查 加载 失败。 但是，由于此加载字符的方法是异步处理的，因此请在 RequestComplete 事件中检查其状态。 此方法无法使用 UNC 协议加载字符，因为 加载 方法是同步处理的。