다음을 통해 공유


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

업데이트: 2010년 6월

TextTransform.exe는 텍스트 템플릿을 변환하는 데 사용할 수 있는 명령줄 도구입니다. TextTransform.exe 호출할 때 인수로 텍스트 템플릿 파일의 이름을 지정합니다. TextTransform.exe는 텍스트 변환 엔진을 호출하고 텍스트 템플릿을 처리합니다. TextTransform.exe는 일반적으로 스크립트에서 호출됩니다.

참고

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

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

\Program Files\Common Files\Microsoft Shared\TextTemplating\10.0

TextTransform [<options>] <templateName>

매개 변수

인수

설명

templateName

변환할 템플릿 파일의 이름을 식별합니다.

Option

설명

-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(String, String, String)를 사용합니다. 텍스트 템플릿에서는 템플릿 지시문에 hostspecific을 포함하고 this.Host에서 메시지를 호출합니다. 예를 들면 다음과 같습니다.

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

-h

도움말을 제공합니다.

관련 항목

Task

항목

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

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

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

T4 텍스트 변환 사용자 지정

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

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

변경 기록

날짜

변경 내용

이유

2010년 6월

옵션에 대한 정보가 추가되었습니다.

고객 의견