Aracılığıyla paylaş

Özel bir Konak kullanarak Metin Şablonlarını İşleme

  • Makale

Metin şablonu dönüştürme işlemi, giriş olarak bir metin şablonu dosyası alır ve çıkış olarak bir metin dosyası oluşturur. Metin dönüştürme altyapısını bir Visual Studio uzantısından veya Visual Studio'nun yüklü olduğu bir makinede çalışan tek başına bir uygulamadan çağırabilirsiniz. Ancak, metin şablon oluşturma konağı sağlamanız gerekir. Bu sınıf, derlemeler ve ekleme dosyaları gibi kaynakları bularak ve çıktı ve hata iletilerini işleme alarak şablonu ortama bağlar.

İpucu

Visual Studio'da çalışacak bir paket veya uzantı yazıyorsanız, kendi konağınızı yazmak yerine metin şablon oluşturma hizmetini kullanmayı göz önünde bulundurun. Daha fazla bilgi için bkz . VS Uzantısında Metin Dönüştürmeyi Çağırma.

Not

Metin şablonu dönüştürmelerinin sunucu uygulamalarında kullanılması önerilmez. Metin şablonu dönüştürmelerinin tek bir iş parçacığı dışında kullanılması önerilmez. Bunun nedeni, metin şablonu oluşturma motorunun şablonları çevirmek, derlemek ve yürütmek için tek bir AppDomain öğesini yeniden kullanmasıdır. Çevrilen kod, iş parçacığı açısından güvenli olmak üzere tasarlanmamıştır. Altyapı, bir Visual Studio projesinde tasarım zamanında oldukları için dosyaları seri olarak işlemek üzere tasarlanmıştır.

Çalışma zamanı uygulamaları için, önceden işlenmiş metin şablonlarını kullanmayı göz önünde bulundurun: bkz . T4 Metin Şablonları ile Çalışma Zamanı Metin Oluşturma.

Uygulamanız, derleme zamanında sabitlenmiş bir grup şablon kullanıyorsa, Önceden İşlenmiş Metin Şablonlarının kullanılması daha kolaydır. Uygulamanız Visual Studio'nun yüklü olmadığı bir makinede çalışacaksa bu yaklaşımı da kullanabilirsiniz. Daha fazla bilgi için bkz . T4 Metin Şablonları ile Çalışma Zamanı Metin Oluşturma.

Uygulamanızda Metin Şablonu Yürütme

Metin şablonu yürütmek için processTemplate yöntemini Microsoft.VisualStudio.TextTemplating.Engineçağırırsınız:

using Microsoft.VisualStudio.TextTemplating;
...
Engine engine = new Engine();
string output = engine.ProcessTemplate(templateString, host);

Uygulamanızın şablonu bularak sağlaması ve çıktı ile işlem yapması gerekir.

parametresindehost, ITextTemplatingEngineHost uygulayan bir sınıf sağlamanız gerekir. Bu, Motor tarafından geri çağrılır.

Ana bilgisayar hataları günlüğe kaydedebilmeli, derleme ve ekleme dosyalarına yapılan başvuruları çözümleyebilmeli, şablonun yürütülebileceği bir Uygulama Etki Alanı sağlayabilmeli ve her yönerge için uygun işlemciyi çağırabilmelidir.

Microsoft.VisualStudio.TextTemplating.EngineMicrosoft.VisualStudio.TextTemplating.*.0.dll içinde tanımlanır ve ITextTemplatingEngineHost, Microsoft.VisualStudio.TextTemplating.Interfaces.*.0.dll içinde tanımlanır.

Bu bölümde

İzlenecek yol: Özel Metin Şablonu Konağı oluşturmak, metin şablonu işlevselliğini Visual Studio dışında kullanılabilir hale getiren özel bir metin şablonu konağı oluşturmayı gösterir.

Başvuru

Itexttemplatingenginehost

İlgili içerik