Microsoft.VisualStudio.TextTemplating - пространство имен

Пространство имен Microsoft.VisualStudio.TextTemplating предоставляет классы для функциональности преобразования текстовых шаблонов.Модуль преобразования текстового шаблона интегрирован в Visual Studio и преобразует файлы текстовых шаблонов в сгенерированные выходные текстовые файлы.

Процесс преобразования текстового шаблона принимает в качестве входных данных файл текстового шаблона, обрабатывает данные и создает новый текстовый файл.Для завершения процесса, компонент ядра контролирует процесс и взаимодействует с узлом преобразования шаблона текста, и с одним или несколькими процессорами директивы шаблона текста.Дополнительные сведения см. в разделе Создание кода и текстовые шаблоны T4.

Процесс преобразования текстового шаблона состоит из двух шагов.На первом шаге обработчик преобразования текстового шаблона создает класс, обращение к которому производится как к генерируемому классу преобразования.На втором этапе ядро компилирует и выполняет сгенерированный класс преобразования, чтобы выдать сгенерированный выходной текст.Созданный класс преобразования состоит из кода текстового шаблона, т.е., операторов, выражений, функций класса, стандартного текста в текстовом шаблоне и результатов вызова процессоров директивы.Дополнительные сведения см. в разделе Написание текстового шаблона T4.

Опытным пользователям может потребоваться реализовать собственный узел обработчика преобразования текстовых шаблонов или процессоры директив.Дополнительные сведения см. в следующих разделах.

• Настройка преобразования текста T4

• ITextTemplatingEngineHost

• DirectiveProcessor

• RequiresProvidesDirectiveProcessor

Классы

	Класс	Описание
	AssemblyCacheMonitor	Контролирует состояние кэша сборок.
	DirectiveProcessor	Абстрактный базовый класс для процессора конкретных директив.
	DirectiveProcessorAttribute
	DirectiveProcessorException	Исключение, выдаваемое модулем преобразования текстовых шаблонов в случае ошибки при обработке директив.
	EncodingHelper	Служебный класс, получающий кодировку файла на основе его метки порядка байтов.
	Engine	Модуль преобразования текстового шаблона.
	ParameterDirectiveProcessor	Процессор директив для отправки простых сериализуемых параметров от вызывающего кода или основного приложения в шаблон.
	RequiresProvidesDirectiveProcessor	Абстрактный базовый класс для процессора директив, определяющий и реализующий шаблон, который называется "requires/provides".
	ServiceProviderExtensions	Класс, содержащий расширения IServiceProvider, соответствующие шаблонам T4.
	ShadowCopyMonitor	Контролирует состояние тен- скопированных сборок для использования узлами.
	SupportedDirectiveAttribute
	TextTemplatingSession	Тривиальная реализация интерфейса сеанса преобразования текста.
	TextTransformation	Абстрактный базовый класс для всех создаваемых классов преобразования.Этот класс также предоставляет вспомогательные методы и свойства, используемые в коде текстового шаблона.
	ToStringHelper	Служебный класс, который предназначен для создания связанного с конкретными языком и региональными параметрами представления объекта Object в виде String.
	TransformedAllTemplatesEventArgs
	TransformingAllTemplatesEventArgs

Интерфейсы

	Интерфейс	Описание
	IDebugTextTemplatingEngine
	IDebugTransformationRun
	IDebugTransformationRunFactory
	IDirectiveProcessor	Интерфейс для процессора директив.
	IDirectiveProcessorMetadata	Метаданные, предоставляемые DirectiveProcessors.Основные приложения, которым требуется импортировать DPS через MEF могут использовать эти стандартные метаданные.
	IRecognizeHostSpecific	Этот метод реализуется в процессорах директив для получения состояния флажка HostSpecific в текстовом шаблоне.
	ITextTemplatingEngine	Интерфейс для обработчика преобразования текстового шаблона.
	ITextTemplatingEngineHost	Интерфейс для узла, преобразующего текстовые шаблоны.Этот объект доступен обработчикам директив, доступ к нему также может осуществляться из текстовых шаблонов.
	ITextTemplatingOrchestrator
	ITextTemplatingSession	Может использоваться для передачи информации из процессора директив в текстовый шаблон.
	ITextTemplatingSessionHost	Реализуется в основном приложении текстовых шаблонов и позволяет вызывающему коду получить объект, обозначающий текущий сеанс.Сеанс представляет серию выполнений текстовых шаблонов.Объект сеанса можно использовать для передачи информации из основного приложения в код текстового шаблона.