Método Engine.ProcessTemplate

Artigo
10/26/2012

Transforma o conteúdo de um arquivo de modelo de texto para produzir saída gerada de texto.

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

Sintaxe

'Declaração
Public Function ProcessTemplate ( _
    content As String, _
    host As ITextTemplatingEngineHost _
) As String

public string ProcessTemplate(
    string content,
    ITextTemplatingEngineHost host
)

public:
virtual String^ ProcessTemplate(
    String^ content, 
    ITextTemplatingEngineHost^ host
) sealed

abstract ProcessTemplate : 
        content:string * 
        host:ITextTemplatingEngineHost -> string 
override ProcessTemplate : 
        content:string * 
        host:ITextTemplatingEngineHost -> string

public final function ProcessTemplate(
    content : String, 
    host : ITextTemplatingEngineHost
) : String

Parâmetros

content
Tipo: System.String
O conteúdo do arquivo de modelo de texto a ser inserido.

host
Tipo: Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost
ITextTemplatingEngineHost que hospedará esse mecanismo.

Valor de retorno

Tipo: System.String
A saída gerada texto do arquivo de modelo de texto.

Implementações

ITextTemplatingEngine.ProcessTemplate(String, ITextTemplatingEngineHost)

Exceções

Exceção	Condição
ArgumentNullException	content é nulluma referência nula (Nothing no Visual Basic). - ou - host é nulluma referência nula (Nothing no Visual Basic).

ArgumentNullException

content é nulluma referência nula (Nothing no Visual Basic).

- ou -

host é nulluma referência nula (Nothing no Visual Basic).

Comentários

Em Visual Studio, se um arquivo de Ferramenta Personalizada tem sua propriedade definida como TextTemplatingFileGenerator, clique Executar Ferramenta Personalizada na interface do usuário corresponde ao chamar ProcessTemplate para transformar o modelo.

Para obter mais informações, consulte How to: Create Text Templates e Modelos de processamento de texto por meio de um Host personalizado.

Dica
Se você estiver escrevendo um pacote ou uma extensão que sejam executados dentro de Visual Studio, considere usar o serviço modelos do texto em vez de escrever seu próprio host.Para mais informações, consulte Invocar a transformação de texto em uma extensão do 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)

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.