Engine, classe

Article
05/16/2015

Moteur de transformation du modèle de texte.

Hiérarchie d'héritage

Object
Microsoft.VisualStudio.TextTemplating.Engine

Espace de noms : Microsoft.VisualStudio.TextTemplating
Assembly : Microsoft.VisualStudio.TextTemplating.12.0 (dans Microsoft.VisualStudio.TextTemplating.12.0.dll)

Syntaxe

'Déclaration
Public Class Engine _
    Implements ITextTemplatingEngine, IDebugTextTemplatingEngine

public class Engine : ITextTemplatingEngine, IDebugTextTemplatingEngine

public ref class Engine : ITextTemplatingEngine, IDebugTextTemplatingEngine

type Engine =  
    class 
        interface ITextTemplatingEngine 
        interface IDebugTextTemplatingEngine 
    end

public class Engine implements ITextTemplatingEngine, IDebugTextTemplatingEngine

Le type Engine expose les membres suivants.

Constructeurs

	Nom	Description
	Engine	Initialise une nouvelle instance de la classe Engine.

Début

Méthodes

	Nom	Description
	Equals	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage par défaut. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	MemberwiseClone	Crée une copie superficielle du Object actuel. (Hérité de Object.)
	PrepareTransformationRun	Prépare un objet d'IDebugTransformationRun exécuter le modèle.
	PreprocessTemplate	Génère le code à partir d'un modèle qui, lorsqu'il est compilé et exécuté, produit la sortie du modèle.
	ProcessTemplate	Transforme le contenu d'un fichier de modèle de texte en vue de produire la sortie de texte générée.
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Champs

	Nom	Description
	CacheAssembliesOptionString	Chaîne de CacheAssemblies.
	TemplateFileParameterName

Début

Notes

Le processus de transformation des modèles de texte prend un fichier de modèle de texte comme entrée et génère un fichier texte en tant que sortie. L'élément du moteur de transformation de texte contrôle le processus et interagit avec un hôte de transformation de texte et un ou plusieurs processeurs de noms de modèles de texte pour terminer le processus. Pour plus d'informations, consultez Génération de code et modèles de texte T4.

Conseil

Si vous entrez un package ou une extension qui s'exécutent dans Visual Studio, envisagez d'utiliser le service de création de modèles de texte au lieu d'écrire votre propre hôte.Pour plus d'informations, consultez Appel d'une transformation de texte dans une extension VS.

Exemples

L'exemple suivant montre comment créer une instance du Engine, et appeler ProcessTemplate pour transformer un modèle de texte.

Cet exemple de code fait partie d'un exemple plus complet fourni pour l'interface 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)

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.