TextTransform yardımcı programıyla dosya oluşturma
TextTransform.exe, metin şablonunu dönüştürmek için kullanabileceğiniz bir komut satırı aracıdır. TextTransform.exe'yi çağırdığınızda, metin şablonu dosyasının adını bağımsız değişken olarak belirtirsiniz. TextTransform.exe, metin dönüştürme altyapısını çağırır ve metin şablonunu işler. TextTransform.exe genellikle betiklerden çağrılır. Ancak, genellikle gerekli değildir, çünkü Visual Studio'da veya derleme işleminde metin dönüşümü gerçekleştirebilirsiniz.
Not
Derleme işleminin bir parçası olarak metin dönüşümü gerçekleştirmek istiyorsanız, MSBuild metin dönüştürme görevini kullanmayı göz önünde bulundurun. Daha fazla bilgi için bkz . Derleme İşleminde Kod Oluşturma. Visual Studio'nun yüklü olduğu bir makinede, metin şablonlarını dönüştürebilen bir uygulama veya Visual Studio Uzantısı da yazabilirsiniz. Daha fazla bilgi için bkz . Özel Ana Bilgisayar Kullanarak Metin Şablonlarını İşleme.
TextTransform.exe aşağıdaki dizinde bulunur:
\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\IDE
Professional sürümü için veya
\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE
Enterprise sürümü için.
\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE
Professional sürümü için veya
\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE
Enterprise sürümü için.
Sözdizimi
TextTransform [<options>] <templateName>
Parametreler
| Bağımsız değişken | Açıklama |
|---|---|
templateName |
Dönüştürmek istediğiniz şablon dosyasının adını tanımlar. |
| Seçenek | Açıklama |
|---|---|
| -out<dosya adı> | Dönüşümün çıktısının yazıldığı dosya. |
| -r<derlemesi> | Metin şablonunu derlemek ve çalıştırmak için kullanılan derleme. |
| -u<ad alanı> | Şablonu derlemek için kullanılan ad alanı. |
| -I<includedirectory> | Belirtilen metin şablonuna dahil edilen metin şablonlarını içeren dizin. |
| -P<başvuru yolu> | Metin şablonu içinde belirtilen derlemeleri aramak veya -r seçeneğini kullanmak için bir dizin. Örneğin, Visual Studio API'sinde kullanılan derlemeleri eklemek için -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies" |
| -dp<processorName>!<className>!<assemblyName|codeBase> | Metin şablonu içindeki özel yönergeleri işlemek için kullanılabilecek bir yönerge işlemcisinin adı, tam tür adı ve derlemesi. |
| -a [processorName]![ directiveName]!<parameterName>!<parameterValue> | Yönerge işlemcisi için parametre değeri belirtin. Yalnızca parametre adını ve değerini belirtirseniz, parametre tüm yönerge işlemcileri tarafından kullanılabilir. Bir yönerge işlemcisi belirtirseniz, parametresi yalnızca belirtilen işlemci tarafından kullanılabilir. Bir yönerge adı belirtirseniz, parametresi yalnızca belirtilen yönerge işlenirken kullanılabilir. Parametre değerlerine yönerge işlemcisinden veya metin şablonundan erişmek için ITextTemplatingEngineHost.ResolveParameterValue kullanın. Metin şablonunda şablon yönergesine ekleyin hostspecific ve üzerinde this.Hostiletiyi çağırın. Örneğin:<#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>].İsteğe bağlı işlemci ve yönerge adlarını atlasanız bile her zaman '!' işaretlerini yazın. Örneğin: -a !!param!value |
| -h | Yardım sağlar. |