Générer des fichiers avec l’utilitaire TextTransform

TextTransform.exe est un outil en ligne de commande qui vous permet de transformer un modèle de texte. Quand vous appelez TextTransform.exe, vous spécifiez le nom d’un fichier de modèle texte en tant qu’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. Cependant, cela n’est pas le passage obligé. Vous pouvez en effet effectuer une transformation de texte dans Visual Studio ou lors du processus de génération.

Notes

Si vous souhaitez effectuer une transformation de texte dans le cadre d’un processus de génération, envisagez d’utiliser la tâche de transformation de texte MSBuild. Pour plus d'informations, consultez Génération de code dans un processus de génération. Sur un ordinateur doté de Visual Studio, vous pouvez aussi écrire une application ou une extension Visual Studio capable de 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\Microsoft Visual Studio\2022\Professional\Common7\IDE

pour Professional Edition ou

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

pour Enterprise Edition.

Syntaxe

TextTransform [<options>] <templateName>

Paramètres

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

Option	Description
-out<filename>	Fichier dans lequel le résultat de la transformation est écrit.
-r<assembly>	Assembly utilisé pour compiler et exécuter le modèle de texte.
-u<namespace>	Espace de noms utilisé pour compiler le modèle.
-I<includedirectory>	Répertoire qui contient les modèles de texte inclus dans le modèle de texte spécifié.
-P<referencepath>	Répertoire où rechercher les assemblys spécifiés dans le modèle de texte ou pour utiliser l’option -r. Par exemple, pour inclure les 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>	Spécifiez une valeur de paramètre pour un processeur de directive. Si vous spécifiez uniquement le nom et la valeur du paramètre, le paramètre est disponible pour tous les processeurs de directive. Si vous spécifiez un processeur de directive, le paramètre est disponible uniquement pour le processeur spécifié. Si vous spécifiez un nom de directive, le paramètre est disponible uniquement pendant le traitement de la directive spécifiée. Pour accéder aux valeurs de paramètres à partir d’un processeur de directive ou d’un modèle de texte, utilisez ITextTemplatingEngineHost.ResolveParameterValue. Dans un modèle de texte, incluez hostspecific dans la directive de modèle et appelez le message sur this.Host. Par exemple : <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. Tapez toujours les marques « ! », même si vous omettez les noms de processeur et de directive facultatifs. Par exemple : -a !!param!value
-h	Fournit de l’aide.

Contenu connexe

• Génération de code durant la conception à l'aide de modèles de texte T4
• Personnalisation d'une transformation de texte T4
• Traitement des modèles de texte à l'aide d'un hôte personnalisé