다음을 통해 공유


사용자 지정 매개 변수

사용자 지정 매개 변수는 마법사가 시작된 후 마법사의 작업을 제어합니다. 관련 .vsz 파일은 IDE(통합 개발 환경)에 의해 패키지된 다음 마법사가 시작될 때 문자열 배열로 마법사에 전달되는 사용자 정의 매개 변수 배열을 제공합니다. 그런 다음, 마법사는 문자열 배열을 구문 분석하고 정보를 사용하여 마법사의 실제 작업을 제어합니다. 이러한 방식으로 마법사는 .vsz 파일의 내용에 따라 기능을 사용자 지정할 수 있습니다.

반면에 컨텍스트 매개 변수는 마법사가 시작될 때 프로젝트의 상태를 정의합니다. 자세한 내용은 컨텍스트 매개 변수를 참조하세요.

다음은 사용자 지정 매개 변수가 있는 .vsz 파일의 예입니다.

VSWIZARD 8.0
Wizard=VsWizard.VsWizard_Engine
Param="WIZARD_NAME = Sample Wizard"
Param="WIZARD_UI = FALSE"
Param="RELATIVE_PATH = VSWizards\Classwiz\ATL"
Param="PREPROCESS_FUNCTION = CanAddATLSupport"
Param="PROJECT_TYPE = CSPROJ"

.vsz 파일의 작성자는 매개 변수 값을 추가합니다. 사용자가 파일 메뉴에서 새 프로젝트새 항목 추가를 선택하거나 솔루션 탐색기에서 마우스 오른쪽 단추로 프로젝트를 클릭하면 IDE에서 이 값들을 문자열 배열로 수집합니다. 그런 다음 IDE는 VSADDITEMOPERATION 플래그 집합을 사용해 프로젝트의 AddItem 메서드를 호출하고 프로젝트는 마법사를 실행해 결과를 반환하는 RunWizardFile 메서드를 호출합니다.

마법사는 문자열 배열을 구문 분석하고 문자열에 적절하게 작동합니다. 이러한 방식으로 사용자 지정 매개 변수를 구현하여 다양한 함수를 수행하는 하나의 마법사를 만들 수 있습니다. 다시 말해, 마법사 하나에는 각각의 .vsz 파일이 세 개씩 있을 수 있습니다. 각 파일은 다양한 상황에서 마법사의 동작을 제어하기 위해 다양한 사용자 지정 매개 변수 집합을 전달합니다.

자세한 내용은 마법사 (.vsz) 파일을 참조하세요.