Klasa Engine

Artykuł
10/27/2012

Aparat tekst szablonu transformacji.

Hierarchia dziedziczenia

System.Object
Microsoft.VisualStudio.TextTemplating.Engine

Przestrzeń nazw: Microsoft.VisualStudio.TextTemplating
Zestaw: Microsoft.VisualStudio.TextTemplating.11.0 (w Microsoft.VisualStudio.TextTemplating.11.0.dll)

Składnia

'Deklaracja
Public Class Engine _
    Implements IDebugTextTemplatingEngine, ITextTemplatingEngine

public class Engine : IDebugTextTemplatingEngine, ITextTemplatingEngine

public ref class Engine : IDebugTextTemplatingEngine, ITextTemplatingEngine

type Engine =  
    class
        interface IDebugTextTemplatingEngine
        interface ITextTemplatingEngine
    end

public class Engine implements IDebugTextTemplatingEngine, ITextTemplatingEngine

Typ Engine uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	Engine	Inicjuje nowe wystąpienie Engine klasy.

Początek

Metody

	Nazwa	Opis
	Equals	Określa, czy określony obiekt jest równa bieżącego obiektu. (Odziedziczone z Object).
	Finalize	Umożliwia obiekt spróbuj zwolnić zasoby i wykonywania innych operacji oczyszczania, zanim jest odzyskane w procesie wyrzucania elementów bezużytecznych. (Odziedziczone z Object).
	GetHashCode	Służy jako funkcja mieszania dla określonego typu. (Odziedziczone z Object).
	GetType	Pobiera Type bieżącej instancji. (Odziedziczone z Object).
	MemberwiseClone	Tworzy kopię płytkie bieżące Object. (Odziedziczone z Object).
	PrepareTransformationRun	Przygotowuje obiektu IDebugTransformationRun uruchomić szablonu.
	PreprocessTemplate	Generuje kod z szablonu, który podczas kompilacji i uruchomić, da wynik szablonu.
	ProcessTemplate	Przekształca zawartość pliku szablonu tekstu do generowania danych wyjściowych generowanych tekstu.
	ToString	Zwraca ciąg, który reprezentuje bieżącego obiektu. (Odziedziczone z Object).

Początek

Pola

	Nazwa	Opis
	CacheAssembliesOptionString	Ciąg opcji CacheAssemblies.
	TemplateFileParameterName

Początek

Uwagi

Proces transformacji tekst szablonu ma plik szablonu tekst wejściowy i tworzy nowy plik tekstowy jako dane wyjściowe.Tekst szablonu transformacji silnika składnik kontroluje proces i współdziała z tekst szablonu transformacji hosta i jeden lub więcej tekstu szablonu dyrektywa procesorów na zakończenie procesu.Aby uzyskać więcej informacji, zobacz Kod generacji i szablony tekst T4.

Porada
Jeśli piszesz pakietu lub rozszerzenia, które będzie uruchamiane w ramach Visual Studio, należy rozważyć użycie zamiast pisać własne hosta usługi tekstowej języków.Aby uzyskać więcej informacji, zobacz Wywoływanie przekształcenie tekstu w rozszerzeniu VS.

Przykłady

Poniższy przykład ilustruje sposób tworzenia wystąpienia Engine, a wywołanie ProcessTemplate do przekształcania tekstu szablonu.

Poniższy przykład kodu jest częścią większych przykład, przewidziane ITextTemplatingEngineHost interfejsu.

Engine engine = new Engine();

//read the text template
string input = File.ReadAllText(templateFileName);

//transform the text template
string output = engine.ProcessTemplate(input, host);

Dim engine As Engine = New Engine()

'read the text template
Dim input As String = File.ReadAllText(templateFileName)

'transform the text template
Dim output As String = engine.ProcessTemplate(input, host)

Bezpieczeństwo wątku

Wszystkie publiczne static (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Wystąpienia elementów członkowskich nie dają gwarancji bezpieczeństwa wątków.