Load 메서드

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

Description

문자를 Characters 컬렉션에 로드합니다.

Syntax

agent**. Characters.Load "CharacterID",** 공급자

부분 Description
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"

컨트롤의 단일 instance 동일한 문자(GUID가 동일한 문자)를 두 번 이상 로드할 수 없습니다. 마찬가지로 기본 문자는 다른 문자와 같을 수 있으므로 컨트롤의 단일 instance 기본 문자와 다른 문자를 동시에 로드할 수 없습니다. 이 작업을 수행하려고 하면 서버에서 오류가 발생합니다. 그러나 에이전트 컨트롤의 다른 instance 만들고 동일한 문자를 로드할 수 있습니다.

Microsoft 에이전트 데이터 공급자는 단일 구조화된 파일()로 저장된 문자 데이터 로드를 지원합니다. ACS) 문자 데이터 및 애니메이션 데이터를 함께 사용하거나 별도의 문자 데이터()로 사용합니다. ACF) 및 애니메이션(. ACA) 파일. 단일 구조화된 를 사용합니다. ACS 파일은 로컬 디스크 또는 네트워크에 저장되고 기존 파일 프로토콜(예: UNC 경로 이름)을 사용하여 액세스되는 문자를 로드합니다. 별도의 를 사용합니다. ACF 및 입니다. HTTP 프로토콜을 사용하여 액세스되는 원격 사이트에서 애니메이션 파일을 개별적으로 로드하려는 경우 ACA 파일입니다.

의 경우 LOAD 메서드를 사용하는 ACS 파일은 문자의 애니메이션에 대한 액세스를 제공합니다. 의 경우 ACF 파일도 Get 메서드를 사용하여 애니메이션 데이터를 로드합니다. Load 메서드는 다운로드를 지원하지 않습니다. HTTP 사이트의 ACS 파일입니다.

문자를 로드해도 문자가 자동으로 표시되지는 않습니다. 먼저 Show 메서드를 사용하여 문자를 표시합니다.

Load 메서드를 사용하여 로컬 컴퓨터에 저장된 문자 파일을 로드하면 호출이 실패합니다. 예를 들어 파일을 찾을 수 없으므로 에이전트에서 오류가 발생합니다. 프로그래밍 언어의 지원을 사용하여 오류를 catch하고 처리하는 오류 처리 루틴을 제공할 수 있습니다.

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

RaiseRequestErrorsFalse로 설정하고, 개체를 선언하고, 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 프로토콜을 사용하여 Load 메서드에 Request 개체를 할당하여 부하 오류에 대한 검사 수 있습니다. 그러나 문자를 로드하는 이 메서드는 비동기적으로 처리되므로 RequestComplete 이벤트에서 해당 상태 검사. Load 메서드가 동기적으로 처리되므로 이 기술은 UNC 프로토콜을 사용하여 문자를 로드하는 데 작동하지 않습니다.