Condividi tramite


Interfaccia ITextTemplatingEngineHost

l'interfaccia per l'host che trasforma i modelli di testo.È possibile accedere ai processori di direttiva e è inoltre possibile accedere dai modelli di testo.

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

Sintassi

'Dichiarazione
<CLSCompliantAttribute(True)> _
Public Interface ITextTemplatingEngineHost
[CLSCompliantAttribute(true)]
public interface ITextTemplatingEngineHost
[CLSCompliantAttribute(true)]
public interface class ITextTemplatingEngineHost
[<CLSCompliantAttribute(true)>]
type ITextTemplatingEngineHost =  interface end
public interface ITextTemplatingEngineHost

Il tipo ITextTemplatingEngineHost espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica StandardAssemblyReferences Ottiene un elenco dei riferimenti all'assembly.
Proprietà pubblica StandardImports Ottiene un elenco degli spazi dei nomi.
Proprietà pubblica TemplateFile Ottiene il percorso e il nome del file modello di testo che sta sviluppando.

In alto

Metodi

  Nome Descrizione
Metodo pubblico GetHostOption Chiamato dal motore per chiedere il valore di un'opzione specificata.Restituire il valore null se non si conosce.
Metodo pubblico LoadIncludeText Acquisisce il testo che corrisponde a una richiesta di includere un file modello di testo parziale.
Metodo pubblico LogErrors Riceve una raccolta di errori e avvisi dal motore di trasformazione.
Metodo pubblico ProvideTemplatingAppDomain Fornisce un dominio applicazione per eseguire la classe della trasformazione generata.
Metodo pubblico ResolveAssemblyReference Consente a un host di fornire informazioni aggiuntive sulla posizione di un assembly.
Metodo pubblico ResolveDirectiveProcessor Restituisce il tipo di processore di direttiva, specificando il nome descrittivo.
Metodo pubblico ResolveParameterValue Risolve il valore di un parametro per un processore di direttiva se il parametro non è specificato nel testo del modello.
Metodo pubblico ResolvePath Consente a un host di fornire un percorso completo, assegnato un nome file o un percorso relativo.
Metodo pubblico SetFileExtension Indica all'estensione di file che è prevista per l'output di testo generato.
Metodo pubblico SetOutputEncoding Indica alla codifica che è prevista per l'output di testo generato.

In alto

Note

Un host viene preso un file modello di testo come input e viene generato un file di testo come output.Un host tipico consiste TextTemplatingFileGenerator strumento che modelli di trasformazioni in un oggetto Visual Studio progetto.Chiama uno o più processori di direttiva per gestire i diversi tipi di modelli.I membri di questa interfaccia sono accessibili ai processori di direttiva e il codice del modello di testo.I controlli del motore modello testo questo processo e interagiscono con un host e uno o più processori di direttiva.Per ulteriori informazioni su questi componenti, vedere Generazione di codice e modelli di testo T4.

Per rendere l'host accessibile al codice di un modello di testo, impostare hostspecific parametro della direttiva del modello.Ad esempio:

<#@template language="c#" hostspecific="true" #>
<# // This template is specific to the TextTemplatingFileGenerator host,
   // which transforms templates in a Visual Studio project. #>
These are the projects in this solution:
<#=this.Host.ResolveParameterValue("-", "-", "projects") #>

Se si desidera utilizzare modelli di testo all'esterno Visual Studio o con gli strumenti personalizzato, è possibile scrivere un host personalizzato, che implementa questa interfaccia.per un esempio, vedere Procedura dettagliata: creazione di un host del modello di testo personalizzato.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.TextTemplating

Altre risorse

Procedura dettagliata: creazione di un host del modello di testo personalizzato

Generazione di codice e modelli di testo T4