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
	StandardAssemblyReferences	Ottiene un elenco dei riferimenti all'assembly.
	StandardImports	Ottiene un elenco degli spazi dei nomi.
	TemplateFile	Ottiene il percorso e il nome del file modello di testo che sta sviluppando.

In alto

Metodi

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