MSBuild 프로젝트 파일의 데이터 유지
프로젝트 하위 형식은 나중에 사용하기 위해 하위 형식 관련 데이터를 프로젝트 파일에 유지해야 할 수 있습니다. 프로젝트 하위 형식은 프로젝트 파일 지속성을 사용하여 다음 요구 사항을 충족합니다.
프로젝트 빌드의 일부로 사용되는 데이터를 유지합니다. (Microsoft Build Engine에 대한 자세한 내용은 MSBuild를 참조하세요.) 빌드 관련 정보는 다음 중 하나일 수 있습니다.
구성 독립적 데이터입니다. 즉, 비어 있거나 누락된 조건이 있는 MSBuild 요소에 저장된 데이터입니다.
구성 종속 데이터입니다. 즉, 특정 프로젝트 구성에 대해 조건부가 지정된 MSBuild 요소에 저장된 데이터입니다. 예시:
<PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
빌드와 관련이 없는 데이터를 유지합니다. 이 데이터는 XML 스키마에 대해 유효성이 검사되지 않은 자유 형식 XML로 표현할 수 있습니다.
구성 독립적 데이터입니다.
구성 종속 데이터입니다.
빌드 관련 정보 유지
프로젝트 빌드에 유용한 데이터의 지속성은 MSBuild를 통해 처리됩니다. MSBuild 시스템은 빌드 관련 정보의 마스터 테이블을 유지 관리합니다. 프로젝트 하위 형식은 속성 값을 가져와서 설정하기 위해 이 데이터에 액세스해야 합니다. 프로젝트 하위 형식은 유지할 속성을 추가하고 유지되지 않도록 속성을 제거하여 빌드 관련 데이터 테이블을 보강할 수도 있습니다.
MSBuild 데이터를 수정하기 위해 프로젝트 하위 형식은 IVsBuildPropertyStorage를 통해 기본 프로젝트 시스템에서 MSBuild 속성 개체를 검색하는 역할을 합니다. IVsBuildPropertyStorage는 핵심 프로젝트 시스템에 구현된 인터페이스이며 QueryInterface를 실행하여 이에 대한 집계 프로젝트 하위 형식 쿼리입니다.
다음 절차에서는 IVsBuildPropertyStorage를 사용하여 속성을 제거하는 단계를 간략하게 설명합니다.
MSBuild 프로젝트 파일에서 속성을 제거하려면
프로젝트 하위 형식의 IVsBuildPropertyStorage에서
QueryInterface를 호출합니다.제거하려는 속성으로 설정된
pszPropName으로 RemoveProperty를 호출합니다.
빌드가 아닌 관련 정보 유지
빌드에 관계없는 프로젝트 파일의 데이터 지속성은 IPersistXMLFragment를 통해 처리됩니다.
기본 project subtype aggregator 개체, project subtype project configuration 개체 또는 둘 다에서 IPersistXMLFragment를 구현할 수 있습니다.
다음 포인트는 빌드와 관련되지 않은 정보의 지속성에 관한 주요 개념을 간략하게 설명합니다.
기본 프로젝트는 기본 프로젝트 하위 유형(즉, 가장 바깥쪽 프로젝트 하위 형식) 집계 개체를 호출하여 구성 독립적 데이터를 로드하고 저장하며, 프로젝트 하위 유형 프로젝트 구성 개체를 호출하여 구성 종속 데이터를 로드하거나 저장합니다.
기본 프로젝트는 프로젝트 하위 유형 집계의 각 수준에 대해 IPersistXMLFragment의 메서드를 여러 번 호출하고 각 수준에 대한 GUID를 전달합니다.
기본 프로젝트는 특정 프로젝트 하위 형식 전용인 XML 조각을 전달하거나 수신하며 이 메커니즘을 집계 수준 간에 상태를 유지하는 방법으로 사용합니다.
기본 프로젝트는 GUID를 전달하는 가장 바깥쪽 프로젝트 하위 형식의 IPersistXMLFragment구현을 호출합니다. GUID가 가장 바깥쪽 프로젝트 하위 형식에 속하는 경우 호출 자체를 처리합니다. 그렇지 않으면 GUID에 해당하는 프로젝트 하위 형식이 발견될 때까지 내부 프로젝트 하위 형식에 대한 호출을 위임합니다.
프로젝트 하위 형식은 내부 프로젝트 하위 형식에 대한 호출을 위임하기 전이나 후에 XML 조각을 수정할 수도 있습니다. 다음 예제에서는 프로젝트 하위 형식과 관련된 속성을 포함하는 파일의 이름이 해당 프로젝트 하위 형식으로 전달되는 프로젝트 파일에서 발췌한 것을 보여 줍니다.
<ProjectExtensions> <VisualStudio> <FlavorProperties GUID="{<FlavorGUID>}"> <FlavorProject TestFileFolder="TestFile" /> </FlavorProperties> </VisualStudio> </ProjectExtensions>