마법사를 시작하는 데 사용되는 컨텍스트 매개 변수
Visual Studio의 추가 기능은 Visual Studio 2013에서 사용되지 않습니다. 추가 기능을 VSPackage 확장으로 업그레이드하는 것이 좋습니다. 업그레이드에 대한 자세한 내용은 FAQ: VSPackage 확장으로 추가 기능 변환 을 참조하십시오.
컨텍스트 매개 변수는 사용할 마법사 종류, 프로젝트 이름, 마법사 항목의 디렉터리 등 마법사를 시작하는 데 필요한 정보를 제공합니다.
다음과 같은 세 가지 종류의 마법사가 있습니다.
NewProject - 솔루션에 새 프로젝트를 추가합니다.
AddSubProject - 기존 프로젝트에 하위 프로젝트를 추가합니다.
AddItem - 기존 프로젝트에 항목을 추가합니다.
이러한 세 가지 종류의 마법사는 IDTWizard 인터페이스의 Execute 메서드를 사용하여 호출됩니다. Execute 메서드의 필수 매개 변수는 ContextParams입니다. 각 마법사에는 다음 표에서 간략하게 설명하는 정확한 순서에 따라 서로 다른 ContextParams 값 집합을 사용해야 합니다.
마법사 종류 |
매개 변수 |
|---|---|
NewProject |
|
AddSubProject |
|
AddItem |
|
다음 표에서는 모든 컨텍스트 매개 변수 목록과 해당 설명을 보여 줍니다.
설정 |
설명 |
|---|---|
WizardType |
마법사의 형식을 나타내는 상수로 다음과 같은 세 가지 종류가 있습니다.
|
ProjectName |
프로젝트의 이름입니다. |
ProjectItems |
마법사가 작동할 ProjectItems 컬렉션에 대한 포인터이며 프로젝트 계층 구조의 선택을 기준으로 마법사에 전달됩니다. |
LocalDirectory |
로컬 시스템에서 마법사의 작업 프로젝트 파일이 저장되는 위치입니다. |
ItemName |
추가할 항목의 이름입니다. ItemName은 항목 추가 대화 상자에서 사용자가 입력하거나 기본적으로 적용되는 파일 이름입니다. VSDIR 파일에 설정된 플래그에 따라 이 설정은 NULL일 수 있습니다. |
InstallationDirectory |
Visual Studio의 설치 디렉터리 경로입니다. |
FExclusive |
프로젝트가 전용 프로젝트인지 여부를 나타내는 Boolean 값입니다. 전용 프로젝트이면 시스템에서 현재 솔루션을 닫고 새 솔루션을 만든 다음 프로젝트를 추가하고, 전용 프로젝트가 아니면 현재 솔루션에 프로젝트를 추가합니다. |
SolutionName |
디렉터리 또는 .sln 확장명을 제외한 솔루션 이름으로, .suo 파일 이름에도 이 루트 이름이 사용됩니다. SolutionName에 값이 있으면 즉, 빈 문자열이 아니면 NewProject 마법사는 Create를 호출한 후 AddFromTemplate으로 프로젝트를 추가합니다. 그러나 SolutionName이 빈 문자열이면 AddFromTemplate를 호출하기 전에 Create를호출할 필요가 없습니다. |
Silent |
UI(사용자 인터페이스)를 표시하지 않고 모두 기본값을 사용하여 마법사를 자동으로 실행할지 여부를 나타내는 부울 값입니다. Silent의 기본값은 True입니다. |