Share via

Generowanie plików za pomocą narzędzia TextTransform

  • Artykuł

TextTransform.exe to narzędzie wiersza polecenia, którego można użyć do przekształcenia szablonu tekstowego. Podczas wywoływania pliku TextTransform.exe należy określić nazwę pliku szablonu tekstowego jako argument. TextTransform.exe wywołuje aparat przekształcania tekstu i przetwarza szablon tekstu. Plik TextTransform.exe jest zwykle wywoływany ze skryptów. Jednak zwykle nie jest to wymagane, ponieważ można wykonać transformację tekstu w programie Visual Studio lub w procesie kompilacji.

Uwaga

Jeśli chcesz wykonać przekształcenie tekstu w ramach procesu kompilacji, rozważ użycie zadania przekształcania tekstu MSBuild. Aby uzyskać więcej informacji, zobacz Generowanie kodu w procesie kompilacji. Na maszynie, na której jest zainstalowany program Visual Studio, możesz również napisać aplikację lub rozszerzenie programu Visual Studio, które może przekształcać szablony tekstu. Aby uzyskać więcej informacji, zobacz Przetwarzanie szablonów tekstu przy użyciu hosta niestandardowego.

Plik TextTransform.exe znajduje się w następującym katalogu:

\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\IDE

for Professional edition lub

\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE

dla wersji Enterprise.

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

for Professional edition lub

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

dla wersji Enterprise.

Składnia

TextTransform [<options>] <templateName>

Parametry

Argument Opis
templateName Określa nazwę pliku szablonu, który chcesz przekształcić.
Opcja Opis
-out<nazwa pliku> Plik, do którego są zapisywane dane wyjściowe przekształcenia.
-r<zestaw> Zestaw używany do kompilowania i uruchamiania szablonu tekstowego.
-u<przestrzeni nazw> Przestrzeń nazw używana do kompilowania szablonu.
-I<includedirectory> Katalog zawierający szablony tekstowe zawarte w określonym szablonie tekstowym.
-P<referencepath> Katalog do wyszukiwania zestawów określonych w szablonie tekstowym lub do używania opcji -r .

Aby na przykład uwzględnić zestawy używane dla interfejsu API programu Visual Studio, użyj polecenia

-P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase> Nazwa, pełna nazwa typu i zestaw procesora dyrektywy, który może służyć do przetwarzania dyrektyw niestandardowych w szablonie tekstowym.
-a [processorName]![ directiveName]!<nazwa_parametru>!<Parametervalue> Określ wartość parametru dla procesora dyrektywy. Jeśli określisz tylko nazwę parametru i wartość, parametr będzie dostępny dla wszystkich procesorów dyrektywy. Jeśli określisz procesor dyrektywy, parametr jest dostępny tylko dla określonego procesora. Jeśli określisz nazwę dyrektywy, parametr jest dostępny tylko wtedy, gdy jest przetwarzana określona dyrektywa.

Aby uzyskać dostęp do wartości parametrów z procesora dyrektywy lub szablonu tekstu, użyj elementu ITextTemplatingEngineHost.ResolveParameterValue. W szablonie tekstowym uwzględnij hostspecific w dyrektywie szablonu i wywołaj komunikat w pliku this.Host. Na przykład:

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

Zawsze wpisz znaczniki "!", nawet jeśli pominięto opcjonalne nazwy procesora i dyrektywy. Na przykład:

-a !!param!value
-h Zapewnia pomoc.

Powiązana zawartość