Metodo Engine.ProcessTemplate

Articolo
10/30/2012

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.11.0 (in Microsoft.VisualStudio.TextTemplating.11.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 è impostata la proprietà Strumento personalizzato a TextTemplatingFileGenerator, fare clic Esegui strumento personalizzato nell'interfaccia utente corrisponde all'ProcessTemplate chiamante per trasformare il modello.

Per ulteriori informazioni, vedere How to: Create Text Templates e Elaborazione di modelli di testo tramite un host personalizzato.

Suggerimento
Se si scrive un pacchetto o un'estensione che verrà eseguita in Visual Studio, si consiglia di utilizzare il servizio del modello di testo anziché scrivere un proprio host.Per ulteriori informazioni, vedere Richiamo della trasformazione del testo in un'estensione VS.

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.