Share via


CustomActionData 속성

설치하는 동안 사용자 지정 작업에 의해 수행될 추가 데이터를 지정합니다. 사용자 지정 작업은 설치 마지막에 수행되고 설치에 대한 정보에 액세스할 수 없지만 CustomActionData 속성을 사용하면 사용자 지정 작업에서 읽을 수 있도록 설치 정보를 저장할 수 있습니다.

예를 들어, 배포 프로젝트에 FILESEARCH1의 Property 속성을 가진 파일 검색이 포함된 경우에 CustomActionData 속성을 /MyFile=[FILESEARCH1]로 설정하여 파일 검색에서 반환된 값을 전달할 수 있습니다. 사용자 지정 작업에서 MyFile 속성을 쿼리하여 값을 가져올 수 있습니다.

설명

CustomActionData 속성의 형식은 사용자 지정 작업의 형식에 따라 달라집니다.

  • 사용자 지정 작업이 설치 구성 요소(ProjectInstaller 클래스)인 경우에 CustomActionData 속성의 형식은 /name=value입니다. 각 이름은 고유해야 하며 하나의 값만 가져야 합니다. 값이 여러 개인 경우에는 단일 공백으로 구분해야 합니다. 예를 들면 /name1=value1 /name2=value2와 같습니다. 값에 공백이 포함되어 있는 경우에는 따옴표로 묶어야 합니다. 예를 들면 /name="a value"와 같습니다.

    Windows Installer 속성은 대괄호로 묶어 전달할 수 있습니다. 예를 들면 /name=[PROPERTYNAME]과 같습니다. 디렉터리를 반환하는 **[TARGETDIR]**와 같은 Windows Installer 속성은 대괄호로 묶은 다음 그 뒤에 백슬래시를 붙이고 따옴표로 묶어야 합니다. 예를 들면 /name="[TARGETDIR]\"와 같습니다.

    참고

    사용자 지정 작업을 설치 구성 요소로 처리하려면 InstallerClass 속성을 true로 설정해야 합니다. 자세한 내용은 RunInstallerAttribute을 참조하십시오.

  • exe, .dll, 스크립트 등에 대한 사용자 지정 작업에는 별도의 형식이 필요하지 않습니다. 이는 CustomActionData 속성에 어떤 문자열을 전달하더라도 사용자 지정 작업에서 자체 구문 분석 과정을 거쳐야 하기 때문입니다.

문제 해결

사용자가 입력한 설치 폴더의 경로를 사용자 지정 작업에서 사용하는 경우 ArgumentException 오류 메시지가 표시될 수 있습니다. 이 오류 메시지는 잘못된 디렉터리 또는 URL과 관련되어 있을 수 있습니다.

이 오류 메시지가 나타나지 않도록 하려면 백슬래시를 공백으로 바꿉니다:/name "[TARGETDIR]" =. 그런 다음 값을 구문 분석하고 Combine 메서드를 사용하여 정규화된 경로를 만듭니다.

참고 항목

작업

연습: 사용자 지정 작업을 사용하여 설치하는 동안 메시지 표시

참조

사용자 지정 작업 편집기의 속성

InstallerClass 속성