Classe Engine

Artigo
05/17/2015

O mecanismo de transformação do modelo de texto.

Hierarquia de herança

Object
Microsoft.VisualStudio.TextTemplating.Engine

Namespace: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.12.0 (em Microsoft.VisualStudio.TextTemplating.12.0.dll)

Sintaxe

'Declaração
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

O tipo Engine expõe os membros a seguir.

Construtores

	Nome	Descrição
	Engine	Inicializa uma nova instância da classe Engine.

Superior

Métodos

	Nome	Descrição
	Equals	Determines whether the specified object is equal to the current object. (Herdado de Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Herdado de Object.)
	GetHashCode	Serves as the default hash function. (Herdado de Object.)
	GetType	Gets the Type of the current instance. (Herdado de Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Herdado de Object.)
	PrepareTransformationRun	Preparar um objeto de IDebugTransformationRun para executar o modelo.
	PreprocessTemplate	Gera código de um modelo que, quando é compilado e executado, gerar a saída do modelo.
	ProcessTemplate	Transforma o conteúdo de um arquivo de modelo de texto para produzir saída gerados de texto.
	ToString	Returns a string that represents the current object. (Herdado de Object.)

Superior

Campos

	Nome	Descrição
	CacheAssembliesOptionString	Cadeia de caracteres padrão de CacheAssemblies.
	TemplateFileParameterName

Superior

Comentários

O processo de transformação do modelo de texto utiliza um arquivo de modelo de texto como entrada e produz um novo arquivo de texto como saída. Os controles componentes de mecanismo de transformação do modelo de texto o processo e interagem com um host de transformação do modelo de texto e um ou mais text processadores de diretiva de modelo para concluir o processo. Para obter mais informações, consulte Geração de código e modelos de texto T4.

Dica

Se você estiver escrevendo um pacote ou uma extensão executados dentro de Visual Studio, considere usar o serviço templating de texto em vez de escrever seu próprio host.Para obter mais informações, consulte Invocando transformação de texto em uma extensão VS.

Exemplos

O exemplo a seguir demonstra como criar uma instância de Engine, e o ProcessTemplate de chamada para transformar um modelo de texto.

Este exemplo de código é parte de um exemplo maior fornecido para a interface de ITextTemplatingEngineHost .

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)

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.