TextTransform 유틸리티를 사용하여 파일 생성

TextTransform.exe는 텍스트 템플릿을 변환하는 데 사용할 수 있는 명령줄 도구입니다. TextTransform.exe를 호출하는 경우 텍스트 템플릿 파일의 이름을 인수로 지정합니다. TextTransform.exe는 텍스트 변환 엔진을 호출하고 텍스트 템플릿을 처리합니다. TextTransform.exe는 일반적으로 스크립트에서 호출됩니다. 그러나 Visual Studio 또는 빌드 프로세스에서 텍스트를 변환할 수 있으므로 일반적으로 필요하지 않습니다.

참고 항목

텍스트 변환을 빌드 프로세스의 일부로 수행하려면 MSBuild 텍스트 변환 작업을 사용하는 것이 좋습니다. 자세한 내용은 빌드 프로세스에서 코드 생성을 참조하세요. Visual Studio가 설치된 머신에서 텍스트 템플릿을 변형할 수 있는 애플리케이션 또는 Visual Studio 확장을 작성할 수도 있습니다. 자세한 내용은 사용자 지정 호스트를 사용하여 텍스트 템플릿 처리를 참조하세요.

TextTransform.exe는 다음 디렉터리에 있습니다.

\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE

(Professional 버전의 경우) 또는

\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE

(Enterprise 버전의 경우)

구문

TextTransform [<options>] <templateName>

매개 변수

Argument	설명
templateName	변환하려는 템플릿 파일의 이름을 식별합니다.

옵션	설명
-out<filename>	변환의 출력을 쓸 파일입니다.
-r<assembly>	텍스트 템플릿을 컴파일하고 실행하는 데 사용되는 어셈블리입니다.
-u<namespace>	템플릿을 컴파일하는 데 사용되는 네임스페이스입니다.
-I<includedirectory>	지정된 텍스트 템플릿에 포함된 텍스트 템플릿을 포함하는 디렉터리입니다.
-P<referencepath>	텍스트 템플릿 내에 지정된 어셈블리를 검색하거나 -r 옵션을 사용하는 디렉터리입니다. 예를 들어 Visual Studio API에 사용되는 어셈블리를 포함하려면 다음을 사용합니다. -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase>	텍스트 템플릿 내에서 사용자 지정 지시문을 처리하는 데 사용할 수 있는 지시문 프로세서의 이름, 전체 형식 이름 및 어셈블리입니다.
-a [processorName]![directiveName]!<parameterName>!<parameterValue>	지시문 프로세서에 대한 매개 변수 값을 지정합니다. 매개 변수 이름과 값만 지정 하면 모든 지시문 프로세서에서 매개 변수를 사용할 수 있습니다. 지시문 프로세서를 지정하는 경우 지정된 프로세서에만 매개 변수를 사용할 수 있습니다. 지시문 이름을 지정하는 경우 매개 변수는 지정된 지시문이 처리되는 중에만 사용할 수 있습니다. 지시문 프로세서 또는 텍스트 템플릿에서 매개 변수 값에 액세스하려면 ITextTemplatingEngineHost.ResolveParameterValue를 사용합니다. 텍스트 템플릿에서 템플릿 지시문에 hostspecific을 포함하고 this.Host에서 메시지를 호출합니다. 예시: <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. 선택적 프로세서 및 지시문 이름을 생략하는 경우에도 항상 ‘!’를 입력합니다. 예시: -a !!param!value
-h	도움말을 제공합니다.

관련 콘텐츠

• T4 텍스트 템플릿을 사용하여 디자인 타임 코드 생성
• T4 텍스트 변환 사용자 지정
• 사용자 지정 호스트를 사용하여 텍스트 템플릿 처리