Session.FormatRecord 메서드

Session 개체의 FormatRecord 메서드는 서식이 지정된 문자열을 템플릿에서 반환하고 데이터를 기록합니다.

구문

Session.FormatRecord(
  record
)

매개 변수

record

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

반환 값

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

설명

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

서식을 지정할 매개 변수는 대괄호 [..]로 묶입니다. 대괄호는 안쪽에서 바깥쪽으로 대체가 확인되므로 반복될 수 있습니다.

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

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

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

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

요구 사항

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

참고 항목

포맷

열 데이터 형식