Klasa Engine

Artykuł
05/17/2015

Aparat tekst szablonu transformacji.

Hierarchia dziedziczenia

Object
Microsoft.VisualStudio.TextTemplating.Engine

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

Składnia

'Deklaracja
Public Class Engine _
    Implements ITextTemplatingEngine, IDebugTextTemplatingEngine

public class Engine : ITextTemplatingEngine, IDebugTextTemplatingEngine

public ref class Engine : ITextTemplatingEngine, IDebugTextTemplatingEngine

type Engine =  
    class 
        interface ITextTemplatingEngine 
        interface IDebugTextTemplatingEngine 
    end

public class Engine implements ITextTemplatingEngine, IDebugTextTemplatingEngine

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

Konstruktorzy

	Nazwa	Opis
	Engine	Inicjuje nowe wystąpienie klasy Engine.

Początek

Metody

	Nazwa	Opis
	Equals	Determines whether the specified object is equal to the current object. (Odziedziczone z Object).
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Odziedziczone z Object).
	GetHashCode	Serves as the default hash function. (Odziedziczone z Object).
	GetType	Gets the Type of the current instance. (Odziedziczone z Object).
	MemberwiseClone	Creates a shallow copy of the current Object. (Odziedziczone z Object).
	PrepareTransformationRun	Przygotowuje obiektu IDebugTransformationRun do uruchomienia tego szablonu.
	PreprocessTemplate	Generuje kod z szablonu, który gdy jest skompilowany i uruchomić, da wynik szablonu.
	ProcessTemplate	Przekształca zawartość pliku tekstowego szablonu do generowania danych wyjściowych wygenerowany tekst.
	ToString	Returns a string that represents the current object. (Odziedziczone z Object).

Początek

Pola

	Nazwa	Opis
	CacheAssembliesOptionString	Ciąg opcji CacheAssemblies.
	TemplateFileParameterName

Początek

Uwagi

Proces przekształcania tekstu szablonu ma szablon pliku tekstowym jako dane wejściowe i tworzy nowy plik tekstowy jako dane wyjściowe.Składnik aparat tekst szablonu transformacja kontroluje proces i współdziała z tekst szablonu transformacji host i jeden lub więcej tekstu szablonu w dyrektywie procesory do ukończenia procesu.Aby uzyskać więcej informacji, zobacz Generowanie kodu i szablony tekstowe T4.

Porada
Jeśli piszesz pakiet lub rozszerzenia, które będą uruchamiane w ramach Visual Studio, warto rozważyć użycie zamiast pisać własne hosta usługi tekstowej szablonów.Aby uzyskać więcej informacji, zobacz Wywoływanie transformacji tekstu w rozszerzeniu VS.

Przykłady

Poniższy przykład ilustruje tworzenie instancji Engine, a wywołanie ProcessTemplate do przekształcania tekstu szablonu.

Poniższy przykład kodu jest częścią większy 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.