XslTransformation 작업
XSLT 또는 컴파일된 XSLT 및 출력을 사용하여 XML 입력을 출력 디바이스 또는 파일로 변환합니다.
매개 변수
다음 표에서는 XslTransformation
작업의 매개 변수에 대해 설명합니다.
매개 변수 | Description |
---|---|
OutputPaths |
필수 ITaskItem[] 매개 변수입니다.XML 변환에 대한 출력 파일을 지정합니다. |
Parameters |
선택적 String 매개 변수입니다.매개 변수를 XSLT 입력 문서로 지정합니다. 각 매개 변수를 <Parameter Name="" Value="" Namespace="" /> 로 저장하는 원시 XML을 제공합니다. |
UseTrustedSettings |
선택적 부울 매개 변수입니다.True 인 경우 XSLT document() 함수 및 포함된 스크립트를 사용할 수 있는 완화된 XSLT 보안 설정을 사용하도록 설정합니다. TrustedXslt을 참조하세요. 관련 보안 고려 사항은 보안 고려 사항을 참조 하세요. |
XmlContent |
선택적 String 매개 변수입니다.XML 입력을 문자열로 지정합니다. |
XmlInputPaths |
선택적 ITaskItem[] 매개 변수입니다.XML 입력 파일을 지정합니다. |
XslCompiledDllPath |
선택적 ITaskItem 매개 변수입니다. 컴파일된 XSLT를 지정합니다. |
XslContent |
선택적 String 매개 변수입니다.XSLT 입력을 문자열로 지정합니다. |
XslInputPath |
선택적 ITaskItem 매개 변수입니다. XSLT 입력 파일을 지정합니다. |
설명
Important
XSLT 스타일시트에는 다른 파일 및 포함된 스크립트 블록에 대한 참조가 포함될 수 있습니다. 악의적인 사용자는 실행 시 컴퓨터가 리소스에서 부족해질 때까지 시스템이 처리될 수 있는 데이터 또는 스타일시트를 제공하여 이를 악용할 수 있습니다. 스타일시트가 신뢰할 수 있는 원본에서 제공되지 않는 한 스크립팅 또는 document()
함수 UseTrustedSettings
를 사용하도록 설정하지 마세요. 스타일시트의 원본을 확인할 수 없거나 스타일시트가 신뢰할 수 있는 원본에서 제공되지 않는 경우 기본 XSLT 설정을 사용합니다.
또한 스키마와 같은 외부 리소스를 로드하면 스키마를 호스트하는 모든 서버에서 빌드 발생 및 해당 네트워크 위치를 검색할 수 있습니다.
이 작업은 표에 나열된 매개 변수 외에, Task 클래스에서 직접 상속하는 TaskExtension 클래스의 매개 변수도 상속합니다. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension 기본 클래스를 참조하세요.
예제
다음 예에서는 XSL 변환 파일 transform.xslt를 사용하여 xml 파일 $(XmlInputFileName)
을 수정합니다. 변환된 XML은 $(IntermediateOutputPath)output.xml
에 기록됩니다. XSL 변환에서 입력 매개 변수로 $(Parameter1)
을 사용합니다.
<XslTransformation XslInputPath="transform.xslt"
XmlInputPaths="$(XmlInputFileName)"
OutputPaths="$(IntermediateOutputPath)output.xml"
Parameters="<Parameter Name='Parameter1' Value='$(Parameter1)'/>"/>