共用方式為

Load 方法

[Microsoft代理程式從 Windows 7 開始已被取代，而且可能無法在後續版本的 Windows 中使用。]

描述

將字元載入至 Characters 集合。

語法

代理程式**。Characters.Load “CharacterID”，** Provider

部分 描述
CharacterID 必填。 字串值，您將用來參考要載入的字元數據。
提供者 必填。 必須是下列其中一項的 variant 數據類型：Filespec 指定字元定義檔的本機檔案位置。
URL 字元定義檔的 HTTP 位址。

言論

您可以藉由指定相對路徑（不包含冒號或前置斜線字元），從 Agent 子目錄載入字元。 這會在路徑前面加上 Agent 的字元目錄（位於本地化的 Windows\msagent 目錄中）。 例如，指定下列命令會從 Agent 的 Chars 目錄載入 Genie.acs：

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

您也可以在 Agent 的 Chars 目錄中指定自己的目錄。

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

您可以載入目前設定為目前用戶預設字元的字元，方法是不包含路徑做為 Load 方法的第二個參數。

   Agent.Character.Load "character"

您無法從控件的單一實例多次載入相同的字元（具有相同 GUID 的字元）。 同樣地，您無法同時從控件的單一實例載入預設字元和其他字元，因為預設字元可能與其他字元相同。 如果您嘗試這樣做，伺服器就會引發錯誤。 不過，您可以建立 Agent 控件的另一個實例，並載入相同的字元。

Microsoft代理程式數據提供者支援載入儲存為單一結構化檔案的字元數據。ACS 包含字元數據和動畫數據，或做為個別字元數據（。ACF） 和動畫 （.ACA） 檔案。 使用單一結構化 。ACS 檔案以載入儲存在本機磁碟或網路上的字元，並使用傳統檔案通訊協定存取字元（例如 UNC 路徑名稱）。 使用個別的 。ACF 和 。當您想要從使用 HTTP 通訊協定存取動畫檔案的遠端月臺個別載入動畫檔案時，ACA 檔案。

為。ACS 檔案，使用 Load 方法可讓您存取字元的動畫。 為。ACF 檔案，您也可以使用 Get 方法來載入動畫數據。 Load 方法不支援下載 。來自 HTTP 網站的 ACS 檔案。

載入字元不會自動顯示字元。 請先使用 Show 方法讓字元顯示。

如果您使用 Load 方法來載入儲存在本機電腦上的字元檔案，且呼叫失敗;例如，因為找不到檔案，Agent 會引發錯誤。 您可以使用程式設計語言中的支援，提供錯誤處理例程來攔截和處理錯誤。

   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 通訊協定，您也可以將 Request 物件指派給 Load 方法，以檢查 Load 失敗。 不過，由於這個載入字元的方法是以異步方式處理，因此請檢查其在 RequestComplete 事件中的狀態。 這項技術將無法使用 UNC 通訊協定載入字元，因為 Load 方法會同步處理。

  • Last updated on