Spazio dei nomi Microsoft.VisualStudio.TextTemplating

Lo spazio dei nomi Microsoft.VisualStudio.TextTemplating fornisce classi per la funzionalità di trasformazione del modello di testo.Il motore di trasformazione del modello di testo è integrato in Visual Studio e trasforma i file modello di testo in file di output di testo generato.

Il processo di trasformazione del modello di testo riceve un file di modello di testo come input, esegue la trasformazione dell'input e genera un nuovo file di testo come output.Il componente del motore controlla il processo e interagisce con un host di trasformazione del modello di testo e con uno o più processori di direttiva del modello di testo per completare il processo.Per ulteriori informazioni, vedere Generazione di codice e modelli di testo (T4).

Il processo di trasformazione del modello di testo è costituito da due passaggi.Nel primo passaggio, il motore di trasformazione del modello di testo crea una classe denominata la classe di trasformazione generata.Nel secondo passaggio, il motore compila ed esegue la classe Transformation generata per produrre l'output di testo generato.La classe Transformation generata è costituita dal codice del modello di testo, ovvero, dalle istruzioni, espressioni, funzionalità della classe e dal testo del boilerplate nel modello di testo nonché dai risultati della chiamata ai processori di direttiva.Per ulteriori informazioni, vedere Writing a T4 Text Template.

Gli utenti avanzati potrebbero volere implementare host del motore di trasformazione del modello di testo o processori di direttiva.Per ulteriori informazioni, vedere:

• Customizing T4 Text Transformation

• ITextTemplatingEngineHost

• DirectiveProcessor

• RequiresProvidesDirectiveProcessor

Classi

	Classe	Descrizione
	AssemblyCacheMonitor	Controlla lo stato dell'Assembly Cache.
	DirectiveProcessor	Classe di base astratta per un processore di direttiva concreto.
	DirectiveProcessorException	Eccezione generata dal motore di trasformazione del modello di testo, se si verifica un errore durante l'elaborazione delle direttive.
	EncodingHelper	Classe di utilità che ottiene la codifica di un file dal relativo indicatore dell'ordine dei byte.
	Engine	Il motore di trasformazione del modello di testo.
	ParameterDirectiveProcessor	Processore di direttiva per indirizzare i parametri serializzabili semplici dai chiamanti o dall'host al modello.
	RequiresProvidesDirectiveProcessor	Classe base astratta di un processore di direttiva che definisce e implementa un modello di progettazione denominato requires/provides.
	TextTemplatingSession	Implementazione semplice dell'interfaccia di sessione di trasformazione del testo
	TextTransformation	La classe di base astratta per tutte le classi della trasformazione generata.Questa classe fornisce anche le proprietà e i metodi di utilità da utilizzare nel codice del modello di testo.
	ToStringHelper	Classe di utilità utilizzata per produrre una rappresentazione specifica delle impostazioni cultura di un oggetto Object come un oggetto String.

Interfacce

	Interfaccia	Descrizione
	IRecognizeHostSpecific	I processori di direttiva implementano questo metodo per ottenere lo stato del flag Hostspecific in un modello di testo.
	ITextTemplatingEngine	L'interfaccia per il motore di trasformazione del modello di testo.
	ITextTemplatingEngineHost	Interfaccia dell'host che trasforma i modelli di testo.Ciò è disponibile per i processori di direttiva e può anche essere accessibile da modelli di testo.
	ITextTemplatingSession	Può essere utilizzato per trasmettere informazioni da un processore di direttiva in un modello di testo.
	ITextTemplatingSessionHost	Implementato da un host di modello testo che consente ai chiamanti di ottenere un oggetto che indica la sessione corrente.Una sessione rappresenta una serie di esecuzioni di modelli di testo.L'oggetto sessione può essere utilizzato per passare le informazioni dall'host nel codice del modello di testo.