다음을 통해 공유

Session.FormatRecord 메서드

  • 아티클

Session 개체의 FormatRecord 메서드는 템플릿 및 레코드 데이터에서 형식이 지정된 문자열을 반환합니다.

구문

Session.FormatRecord(
  record
)

매개 변수

record

서식을 지정할 템플릿 및 데이터를 포함하는 필수 Record 개체입니다. 템플릿 문자열은 필드 0과 참조된 데이터 매개 변수로 설정해야 합니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

FormatRecord 메서드는 다음 형식 프로세스를 사용합니다.

서식 있음인 매개 변수는 대괄호[..]로 묶입니다. 대괄호는 대체가 내부에서 외부로 확인되므로 반복될 수 있습니다.

문자열의 일부가 중괄호 { }로 묶이고 대괄호가 없는 경우 중괄호를 포함하여 해당 부분은 변경되지 않은 상태로 유지됩니다.

문자열의 일부가 중괄호로 묶이고 하나 이상의 속성 이름을 포함하는 경우 및 모든 속성을 찾을 수 있는 경우 중괄호 없이 텍스트(확인된 대체 포함)가 표시됩니다. 속성을 찾을 수 없는 경우 중괄호 자체와 중괄호의 모든 텍스트가 제거됩니다.

FormatRecord 메서드를 사용하여 문자열의 서식을 지정하려면

  1. 숫자 매개 변수는 마커를 해당 레코드 필드의 값으로 바꾸어 대체하고, 누락된 값 또는 Null 값은 텍스트를 생성하지 않습니다.
  2. 다음 설명에 언급된 대로 결과로 나온 문자열은 레코드가 아닌 매개 변수를 해당 값으로 바꾸어 처리됩니다.
    • “[propertyname]” 형식의 substring이 발견되면 속성의 값으로 바뀝니다.
    • “[%environmentvariable]” 형식의 substring이 발견되면 환경 변수의 값이 대체됩니다.
    • [#filekey] 양식의 substring이 있는 경우 파일의 전체 경로로 대체되고 filekey 값은 File 테이블의 키로 사용됩니다. [#filekey] 값은 비어 있으며 설치 관리자가 CostInitialize action, FileCost action, CostFinalize 작업을 실행할 때까지 경로로 대체되지 않습니다. [#filekey] 값은 파일이 속한 구성 요소의 설치 상태에 따라 달라집니다. 구성 요소가 원본에서 실행 중인 경우 값은 파일의 원본 위치에 대한 경로입니다. 구성 요소가 로컬로 실행 중인 경우 값은 설치 후 파일의 대상 위치에 대한 경로입니다. 구성 요소가 없으면 경로가 비어 있습니다. 구성 요소의 설치 상태를 확인하는 방법에 대한 자세한 내용은 기능, 구성 요소, 파일 설치 확인을 참조하세요.
    • [$componentkey] 양식의 substring이 있는 경우 구성 요소의 설치 디렉터리로 대체되고 componentkey 값은 구성 요소 테이블의 키로 사용됩니다. [#componentkey] 값은 비어 있으며 설치 관리자가 CostInitialize action, FileCost action, CostFinalize 작업을 실행할 때까지 디렉터리로 대체되지 않습니다. [$componentkey] 값은 구성 요소의 설치 상태와 구성 요소에 따라 달라집니다. 구성 요소가 원본에서 실행 중인 경우 값은 파일의 원본 디렉터리입니다. 구성 요소가 로컬에서 실행 중인 경우 값은 설치 후 대상 디렉터리입니다. 구성 요소가 없으면 값은 비어 있습니다. 구성 요소의 설치 상태를 확인하는 방법에 대한 자세한 내용은 기능, 구성 요소, 파일 설치 확인을 참조하세요.
    • “[\c]” 형식의 substring이 있으면 추가 처리 없이 문자로 바뀝니다. 백슬래시 뒤의 첫 번째 문자만 유지되고 다른 모든 항목은 제거됩니다.

요구 사항

요구 사항 값
버전
 Windows Server 2012, Windows 8, Windows Server 2008 R2 또는 Windows 7의 Windows Installer 5.0. Windows Server 2008 또는 Windows Vista의 Windows Installer 4.0 또는 Windows Installer 4.5. Windows Server 2003 또는 Windows XP의 Windows Installer
DLL
Msi.dll
IID
 IID_ISession 000C109E-0000-0000-C000-000000000046으로 정의됩니다.

추가 정보

서식 있음

열 데이터 형식