Share via


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

TextTransform.exe는 텍스트 템플릿을 변환하는 데 사용할 수 있는 명령줄 도구입니다. TextTransform.exe 호출할 때 인수로 텍스트 템플릿 파일의 이름을 지정합니다. TextTransform.exe는 텍스트 변환 엔진을 호출하고 텍스트 템플릿을 처리합니다. TextTransform.exe는 일반적으로 스크립트에서 호출됩니다. Visual Studio 또는 빌드 프로세스에서 텍스트 변환을 수행할 수 있으므로, 일반적으로 필요한 것 불가능 합니다.

참고

빌드 프로세스의 일부로 텍스트 변환을 수행할 경우에는 MSBuild 텍스트 변환 작업을 사용하는 것이 좋습니다.자세한 내용은 빌드 프로세스의 코드 생성을 참조하십시오.Visual Studio가 설치된 컴퓨터에서 텍스트 템플릿을 변환할 수 있는 응용 프로그램 또는 Visual Studio 확장을 작성할 수도 있습니다.자세한 내용은 사용자 지정 호스트를 사용하여 텍스트 템플릿 처리를 참조하십시오.

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

\Program Files\Common Files\Microsoft Shared\TextTemplating\11.0

TextTransform [<options>] <templateName>

매개 변수

인수

설명

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 >

경고

항상 입력에 '!' 고 선택적 프로세서 지시문 이름은 생략 하는 경우에 표시 됩니다.예를 들면 다음과 같습니다.

-a !!param!value

지시문 프로세서에 대한 매개 변수 값을 지정합니다. 매개 변수 이름 및 값만 지정할 경우 매개 변수는 모든 지시문 프로세서에 사용할 수 있습니다. 지시문 프로세서를 지정하는 경우 지정한 프로세서에만 매개 변수를 사용할 수 있습니다. 지시문 이름을 지정하는 경우 지정한 지시문이 처리될 때만 매개 변수를 사용할 수 있습니다.

지시문 프로세서 또는 텍스트 템플릿에서 매개 변수 값을 액세스하려면 ResolveParameterValue를 사용합니다. 텍스트 템플릿에서는 템플릿 지시문에 hostspecific을 포함하고 this.Host에서 메시지를 호출합니다. 예를 들면 다음과 같습니다.

<#@template language="c#" hostspecific="true"#>
[<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]

-h

도움말을 제공합니다.

관련 항목

Task

항목

Visual Studio 솔루션에서 파일을 생성합니다.

T4 텍스트 템플릿을 사용하여 디자인 타임 코드 생성

자체 데이터 소스를 변환할 지시문 프로세서를 작성합니다.

T4 텍스트 변환 사용자 지정

사용자 응용 프로그램에서 텍스트 템플릿을 호출할 수 있는 텍스트 템플릿 호스트를 작성합니다.

사용자 지정 호스트를 사용하여 텍스트 템플릿 처리