Génération de fichiers avec l'utilitaire TextTransform

TextTransform.exe est un outil en ligne de commande que vous pouvez utiliser pour transformer un modèle de texte. Lorsque vous appelez TextTransform.exe, vous spécifiez le nom d'un fichier de modèle de texte comme un argument. TextTransform.exe appelle le moteur de transformation de texte et traite le modèle de texte. TextTransform.exe est généralement appelé à partir de scripts. Toutefois, il n'est en général pas nécessaire, car vous pouvez exécuter la transformation de texte dans Visual Studio ou dans le processus de génération.

Notes

Si vous souhaitez exécuter la transformation de texte dans le cadre d'un processus de génération, envisagez d'utiliser la tâche de la transformation du texte de MSBuild.Pour plus d'informations, consultez Génération de code dans un processus de génération.Dans un ordinateur sur lequel Visual Studio est installé, vous pouvez également écrire une application ou Extension Visual Studio qui peut transformer des modèles de texte.Pour plus d'informations, consultez Traitement des modèles de texte à l'aide d'un hôte personnalisé.

TextTransform.exe se trouve dans le répertoire suivant :

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

TextTransform [<options>] <templateName>

Paramètres

Argument	Description
templateName	Identifie le nom du fichier modèle que vous souhaitez transformer.

Option	Description
-out <nom du fichier>	Fichier dans lequel la sortie de la transformation est écrite.
-r <assembly>	Un assembly utilisé pour la compilation et l'exécution du modèle de texte.
-u <namespace>	Espace de noms utilisé pour la compilation du modèle.
-I <includedirectory>	Un répertoire qui contient les modèles de texte inclus dans le modèle de texte spécifié.
-P <referencepath>	Un répertoire dans lequel rechercher des assemblys spécifié dans le modèle de texte ou pour l'utilisation de l'option -r. Par exemple, pour inclure des assemblys utilisés pour l'API Visual Studio, utilisez -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp <processorName>!<className>!<assemblyName|codeBase>	Nom, nom de type complet et assembly d'un processeur de directive qui peut être utilisé pour traiter des directives personnalisées dans le modèle de texte.
-a [processorName]![directiveName]!<parameterName>!<parameterValue> Avertissement tapez toujours « ! » marques, même si vous omettez les noms facultatifs de processeur et de directive.Par exemple : -a !!param!value	Spécifiez une valeur de paramètre pour un processeur de directive. Si vous spécifiez juste le nom de paramètre et valeur, le paramètre sera disponible à tous les processeurs de directive. Si vous spécifiez un processeur de directive, le paramètre est uniquement disponible au processeur spécifié. Si vous spécifiez un nom de directive, le paramètre est disponible uniquement lorsque la directive spécifiée est traitée. Pour accéder aux valeurs de paramètre à partir d'un processeur de directive ou d'un modèle de texte, utilisez ResolveParameterValue. Dans un modèle de texte, incluez hostspecific dans la directive de modèle et invoquez le message sur this.Host. Par exemple : <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]
-h	Fournit de l'aide.

Rubriques connexes

Tâche	Rubrique
Génération de fichiers dans une solution Visual Studio.	Génération de code durant la conception à l'aide de modèles de texte T4
Écriture de processeurs de directive pour la transformation de vos propres sources de données.	Personnalisation d'une transformation de texte T4
Écrivez un hôte de création de modèles de texte qui vous permet d'appeler des modèles de texte à partir de votre propre application.	Traitement des modèles de texte à l'aide d'un hôte personnalisé