Dostosowywanie przekształcenia tekstu T4

Szablony tekstu to funkcja programu Visual Studio, która umożliwia generowanie kodu programu lub innych plików tekstowych za pośrednictwem procesu przekształcania. Za pomocą zestawu Visual Studio SDK można rozszerzyć domyślny proces przekształcania szablonu, dostosowując procesor dyrektywy szablonu tekstu lub hosta szablonu tekstowego.

W tej sekcji

Proces przekształcania szablonu tekstu opisuje sposób działania przekształcania tekstu oraz objaśnia rolę hosta szablonu i procesorów dyrektywy.

Tworzenie niestandardowych procesorów dyrektywy szablonu tekstowego T4 Procesor dyrektywy zajmuje się dyrektywami w szablonie, takimi jak <#@template#>. działa podczas kompilacji szablonu i może ładować zestawy i inne zasoby. Może również wstawić kod, który będzie ładować zasoby w czasie wykonywania. Definiując własny procesor dyrektywy, można zmniejszyć złożoność szablonów.

Wywoływanie przekształcenia tekstu w rozszerzeniu programu VS Jeśli piszesz rozszerzenie programu Visual Studio, takie jak polecenie menu lub program obsługi zdarzeń, rozszerzenie może użyć usługi tworzenia szablonów tekstu w celu przekształcenia dowolnego szablonu tekstu. Dane parametrów można przekazać do szablonu przy użyciu obiektu Sesja i pobrać wartości z szablonu przy użyciu <#@parameter#> dyrektywy .

Przetwarzanie szablonów tekstu przy użyciu hosta niestandardowego Po wykonaniu kodu szablonu tekstowego host zapewnia dostęp do plików zewnętrznych i stanu aplikacji. Na przykład host uruchamiający przekształcenia tekstu w programie Visual Studio może zapewnić dostęp do Eksplorator rozwiązań. Wyświetla również błędy w oknie komunikatu o błędzie. Jeśli chcesz uruchamiać przekształcenia tekstu w innym kontekście, możesz zdefiniować własnego hosta, który zapewnia dostęp do usług dostępnych w tym kontekście.

Jeśli piszesz rozszerzenie programu Visual Studio, rozważ użycie istniejącej usługi przekształcania tekstu zamiast pisania własnego hosta. Aby uzyskać więcej informacji, zobacz Wywoływanie przekształcenia tekstu w rozszerzeniu programu VS.

Powiązana zawartość

• Pisanie szablonu tekstowego T4 zawiera składnię dyrektyw szablonu tekstowego i bloków sterujących.