Metodo Engine.ProcessTemplate

Articolo
08/11/2011

Trasforma il contenuto di un file modello di testo per produrre l'output di testo generato.

Spazio dei nomi: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.10.0 (in Microsoft.VisualStudio.TextTemplating.10.0.dll)

Sintassi

'Dichiarazione
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

Parametri

content
Tipo: System.String
Il contenuto del file modello di testo da trasformare.

host
Tipo: Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost
L'interfaccia ITextTemplatingEngineHost che ospiterà il motore.

Valore restituito

Tipo: System.String
L'output di testo generato del file modello di testo.

Implementa

ITextTemplatingEngine.ProcessTemplate(String, ITextTemplatingEngineHost)

Eccezioni

Eccezione	Condizione
ArgumentNullException	content è nullriferimento null (Nothing in Visual Basic). In alternativa host è nullriferimento null (Nothing in Visual Basic).

ArgumentNullException

content è nullriferimento null (Nothing in Visual Basic).

In alternativa

host è nullriferimento null (Nothing in Visual Basic).

Note

In Visual Studio, se un file dispone della proprietà Strumento personalizzato impostata su TextTemplatingFileGenerator e si fa clic su Esegui strumento personalizzato nell'interfaccia utente, questa operazione corrisponde a ProcessTemplate per trasformare il modello.

Per ulteriori informazioni, vedere How to: Create Text Templates e Processing Text Templates by using a Custom Host.

Suggerimento
Se si scrive un pacchetto o un'estensione che verrà eseguita in Visual Studio, anziché scrivere il proprio host, è consigliabile utilizzare il servizio del modello di testo. Per ulteriori informazioni, vedere Invoking Text Transformation in a Visual Studio Extension.

Esempi

Nell'esempio riportato di seguito viene illustrato come creare un'istanza dell'oggetto Engine chiamando il metodo ProcessTemplate per la trasformazione di un modello di testo.

Questo esempio di codice fa parte di un esempio più esaustivo fornito per l'interfaccia 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)

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.