載入方法

  • 發行項

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

描述

將字元載入 Characters 集合。

語法

agent**。Characters.Load 「CharacterID」，** 提供者

部分 描述
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 檔案。

針對 。使用 Load 方法的 ACS 檔案可讓您存取字元的動畫。 針對 。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 要求，來處理錯誤。 然後，使用會檢查Request物件狀態的 語句，遵循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 方法會以同步方式處理。