Membuat file dengan utilitas TextTransform

TextTransform.exe adalah alat baris perintah yang dapat Anda gunakan untuk mengubah templat teks. Saat Anda memanggil TextTransform.exe, Anda menentukan nama file templat teks sebagai argumen. TextTransform.exe memanggil mesin transformasi teks dan memproses templat teks. TextTransform.exe biasanya dipanggil dari skrip. Namun, biasanya tidak diperlukan, karena Anda dapat melakukan transformasi teks baik di Visual Studio atau dalam proses build.

Nota

Jika Anda ingin melakukan transformasi teks sebagai bagian dari proses build, pertimbangkan untuk menggunakan tugas transformasi teks MSBuild. Untuk informasi selengkapnya, lihat Pembuatan Kode dalam Proses Build. Di komputer tempat Visual Studio diinstal, Anda juga dapat menulis aplikasi atau Ekstensi Visual Studio yang dapat mengubah templat teks. Untuk informasi selengkapnya, lihat Memproses Templat Teks dengan menggunakan Host Kustom.

TextTransform.exe terletak di direktori berikut:

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

untuk edisi Profesional, atau

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

untuk edisi Enterprise.

Syntax

TextTransform [<options>] <templateName>

Parameter-parameternya

Argumen	Deskripsi
templateName	Mengidentifikasi nama file templat yang ingin Anda ubah.

Opsi	Deskripsi
-out<filename>	File yang menjadi tempat penyimpanan output transformasi.
-r<assembly>	Rakitan yang digunakan untuk mengkompilasi dan menjalankan templat teks.
-u<namespace>	Namespace yang digunakan untuk mengkompilasi templat.
-I<includedirectory>	Direktori yang berisi templat teks yang disertakan dalam templat teks yang ditentukan.
-P<referencepath>	Direktori untuk mencari rakitan yang ditentukan dalam templat teks atau untuk menggunakan opsi -r . Misalnya, untuk menyertakan rakitan yang digunakan untuk Visual Studio API, gunakan -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase>	Nama, nama jenis lengkap, dan perakitan prosesor direktif yang dapat digunakan untuk memproses arahan kustom dalam templat teks.
-a [processorName]![directiveName]!<parameterName>!<parameterValue>	Tentukan nilai parameter untuk prosesor direktif. Jika Anda hanya menentukan nama dan nilai parameter, parameter akan tersedia untuk semua prosesor direktif. Jika Anda menentukan prosesor direktif, parameter hanya tersedia untuk prosesor yang ditentukan. Jika Anda menentukan nama direktif, parameter hanya tersedia saat arahan yang ditentukan sedang diproses. Untuk mengakses nilai parameter dari prosesor direktif atau templat teks, gunakan ITextTemplatingEngineHost.ResolveParameterValue. Dalam templat teks, sertakan hostspecific dalam direktif templat dan panggil pesan di this.Host. Contohnya: <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. Selalu ketik tanda '!', bahkan jika Anda menghilangkan prosesor opsional dan nama direktif. Contohnya: -a !!param!value
-jam	Menyediakan bantuan.

Konten terkait

• Pembuatan Kode Waktu-Desain menggunakan Templat Teks T4
• Mengustomisasi Transformasi Teks T4
• Memproses Templat Teks dengan menggunakan Host Kustom