Udostępnij za pośrednictwem


Generowanie plików za pomocą narzędzia TextTransform

TextTransform.exe to narzędzie wiersza polecenia można użyć do przekształcania tekstu szablonu.Po wywołaniu TextTransform.exe, określa nazwę pliku szablonu tekst jako argumentu.TextTransform.exe wywołuje silnika przekształcenie tekstu i przetwarza szablon tekstu.TextTransform.exe jest zazwyczaj nazywana ze skryptów.Jednakże nie jest zazwyczaj wymagane, ponieważ przekształcenie tekstu można wykonać w programie Visual Studio lub w procesie kompilacji.

[!UWAGA]

Przekształcenie tekstu jako część procesu tworzenia, należy rozważyć przy użyciu zadanie programu MSBuild tekst transformacji.Aby uzyskać więcej informacji, zobacz Generowanie kodu w procesie kompilacji.W przypadku komputera, na którym Visual Studio jest zainstalowany, można także napisać aplikację lub Visual Studio rozszerzenia, które można przekształcać tekstu szablonów.Aby uzyskać więcej informacji, zobacz Przetwarzanie szablonów tekstowych przy użyciu hosta niestandardowego.

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

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

TextTransform [<options>] <templateName>

Parametry

Argument

Opis

templateName

Identyfikuje nazwę pliku szablonu, który chcesz poddać transformacji.

Opcja

Opis

-out <filename>

Plik, do którego dane wyjściowe przekształcenia są zapisywane.

-r <assembly>

Zespół wykorzystywane do kompilowania i uruchamiania szablonu tekstu.

-u <namespace>

Obszar nazw jest używany do kompilowania szablonu.

-I <includedirectory>

Katalog zawierający szablony tekst zawarte w szablonie określony tekst.

-P <referencepath>

Katalog wyszukiwania dla zespołów, określonych w szablonie tekstu lub za pomocą -r opcji.

Na przykład aby dołączyć zestawów używanych podczas API programu Visual Studio, użyj

-P "% VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"

-dp <processorName>! <className>! <assemblyName|codeBase>

Nazwa, wpisz pełną nazwę i montażu dyrektywa procesor, które mogą być używane do przetwarzania niestandardowych dyrektyw w szablonie tekstu.

-a [processorName]![directiveName]! <parameterName>! <parameterValue>

Informacje dotyczące przestrogiPrzestroga

Zawsze należy wpisać "!" znaki, nawet jeżeli pominięto parametr opcjonalny procesor i nazwy dyrektywy.Na przykład:

-a !!param!value

Określ wartość parametru dla procesora w dyrektywie.Jeśli określisz tylko nazwę parametru i wartości, parametr będą dostępne dla wszystkich procesorów w dyrektywie.Jeśli określisz dyrektywa procesora, parametr jest dostępny tylko dla określonego procesora.Jeśli określono nazwę w dyrektywie, parametr jest dostępny tylko wtedy, gdy określony dyrektywą jest przetwarzana.

Dostęp do wartości parametru z dyrektywy procesora lub tekst szablonu, należy użyć ResolveParameterValue.W szablonie tekst zawiera hostspecific w dyrektywie szablonu i wywoływać wiadomości na this.Host.Na przykład:

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

-h

Zawiera pomoc.

Tematy pokrewne

Zadania

Temat

Generowanie plików w Visual Studio roztworu.

Generowanie kodu czasu projektowania przy użyciu szablonów tekstowych T4

Napisz dyrektywa procesorów do przekształcania źródeł danych.

Dopasowanie transformacji tekstu T4

Napisz hosta dynamicznego tekstu, który pozwala wywołać szablony tekst z własnych aplikacji.

Przetwarzanie szablonów tekstowych przy użyciu hosta niestandardowego