Engine.ProcessTemplate (Método)

Artículo
11/02/2012

Transforma el contenido de un archivo de plantilla del texto para producir el resultado de texto generado.

Espacio de nombres: Microsoft.VisualStudio.TextTemplating
Ensamblado: Microsoft.VisualStudio.TextTemplating.11.0 (en Microsoft.VisualStudio.TextTemplating.11.0.dll)

Sintaxis

'Declaración
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
Contenido del archivo de plantilla de texto que se va a transformar.

host
Tipo: Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost
ITextTemplatingEngineHost que hospedará este motor.

Valor devuelto

Tipo: System.String
Resultado de texto generado del archivo de plantilla de texto.

Implementaciones

ITextTemplatingEngine.ProcessTemplate(String, ITextTemplatingEngineHost)

Excepciones

Excepción	Condición
ArgumentNullException	content es nullreferencia null (Nothing en Visual Basic). O bien host es nullreferencia null (Nothing en Visual Basic).

ArgumentNullException

content es nullreferencia null (Nothing en Visual Basic).

O bien

host es nullreferencia null (Nothing en Visual Basic).

Comentarios

En Visual Studio, si un archivo tiene la propiedad de Herramienta personalizada establecida en TextTemplatingFileGenerator, haga clic en Ejecutar herramienta personalizada en la interfaz de usuario corresponde a ProcessTemplate para transformar la plantilla.

Para obtener más información, vea How to: Create Text Templates y Procesar las plantillas de texto mediante un host personalizado.

Sugerencia
Si está escribiendo una extensión o paquete que se ejecutan dentro de Visual Studio, considere utilizar el servicio de plantillas de texto en lugar de escribir su propio host.Para obtener más información, vea Invocar la transformación de texto en una extensión de VS.

Ejemplos

En el ejemplo siguiente se muestra cómo se crea una instancia de Engine y se llama a ProcessTemplate para transformar una plantilla de texto.

Este ejemplo de código forma parte de un ejemplo más extenso relativo a la interfaz 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)

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.