Przetwarzanie szablony tekstu przy użyciu hosta niestandardowe

Tekst szablonu transformacji procesu ma tekst szablonu pliku jako danych wejściowych i tworzy plik tekstowy jako dane wyjściowe.Można wywoływać mechanizm przekształcenie tekstu z Visual Studio rozszerzenia, lub z aplikacji autonomicznej, uruchomione na komputerze, na którym Visual Studio jest zainstalowany.Jednakże, należy podać tekstu dynamicznego hosta.Ta klasa łączy szablonu do środowiska naturalnego, znajdowanie zasobów, takich jak zestawy, dołączyć pliki i zajmujących się dane wyjściowe i komunikaty o błędach.

Porada
Jeśli piszesz pakietu lub rozszerzenia, które będzie uruchamiane w ramach Visual Studio, należy wziąć pod uwagę przy użyciu usługi dynamicznego tekstu, zamiast pisać własne hosta.Aby uzyskać więcej informacji, zobacz Wywoływanie przekształcenie tekstu w rozszerzeniu VS.

[!UWAGA]

Nie zaleca się przy użyciu tekstu szablonu przekształcenia w aplikacji serwera.Nie zaleca się przy użyciu tekstu szablonu przekształcenia, z wyjątkiem w jednym wątku.Wynika to z dynamicznego tekstu silnika odbywa się za pojedynczego elementu AppDomain do tłumaczenia, kompilować i uruchamiać szablonów.Kod przetłumaczony nie został zaprojektowany jako bezpieczny wątku.Silnik jest przeznaczony do obróbki plików seryjnie, są one w Visual Studio projektu w czasie projektowania.

Aplikacje run-time, należy rozważyć przy użyciu preprocessed szablony tekstu: zobacz Generowanie tekstu Run-Time z szablonami tekst T4.

Jeśli aplikacja używa zestawu szablonów, które są rozwiązywane w czasie kompilacji, jest łatwiejszy w użyciu szablony tekst Preprocessed.Można również użyć tego podejścia Jeśli aplikacja będzie działać na komputerze, na którym Visual Studio nie jest zainstalowany.Aby uzyskać więcej informacji, zobacz Generowanie tekstu Run-Time z szablonami tekst T4.

Wykonywanie szablonu tekstu w aplikacji

Wykonać szablon tekstu, można wywołać metodę ProcessTemplate Microsoft.VisualStudio.TextTemplating.Engine:

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

Aplikacja musi znaleźć zapewniają szablon i muszą radzić sobie z danych wyjściowych.

W host parametr, należy podać klasy, która implementuje ITextTemplatingEngineHost.Jest to wywołanie zwrotne przez silnik.

Host musi być możliwe rejestrowanie błędów, rozpoznać odwołania do zestawu i dołączyć pliki, zapewniają domeny aplikacji, w którym szablonu można wykonać i wywołanie odpowiednich procesora dla każdej dyrektywy.

Microsoft.VisualStudio.TextTemplating.Enginejest zdefiniowany w Microsoft.VisualStudio.TextTemplating.11.0.dll, i ITextTemplatingEngineHost jest zdefiniowany w Microsoft.VisualStudio.TextTemplating.Interfaces.11.0.dll.

W tej sekcji

• Instruktaż: Tworzenie hosta szablon niestandardowy tekst
  Pokazuje, jak utworzyć hosta szablon niestandardowy tekst, który sprawia, że poza dostępne funkcje tekstu szablonu Visual Studio.

Odwołanie

ITextTemplatingEngineHost

Sekcje pokrewne

• Proces transformacji tekst szablonu
  W tym artykule opisano, jak działa przekształcenie tekstu i części użytkownik, który można dostosować.

• Tworzenie niestandardowych T4 tekst szablonu dyrektywy procesorów
  Zawiera omówienie tekst szablonu dyrektywa procesorów.