Поделиться через


Реализация генераторов одного файла

Пользовательское средство ( иногда называемое одним генератором файлов) можно использовать для расширения систем проектов Visual Basic и Visual C# в Visual Studio. Пользовательское средство — это COM-компонент, реализующий IVsSingleFileGenerator интерфейс. С помощью этого интерфейса пользовательское средство преобразует один входной файл в один выходной файл. Результатом преобразования может быть исходный код или любые другие полезные выходные данные. Два примера пользовательских файлов кода, созданных инструментом, — это код, созданный в ответ на изменения в визуальном конструкторе и файлах, созданных с помощью языка описания веб-служб (WSDL).

При загрузке пользовательского средства или входном файле система проекта вызывает Generate метод и передает ссылку на IVsGeneratorProgress интерфейс обратного вызова, в котором средство может сообщить о ходе выполнения пользователю.

Выходной файл, создаваемый пользовательским средством, добавляется в проект с зависимостью от входного файла. Система проекта автоматически определяет имя выходного файла на основе строки, возвращаемой реализацией пользовательского DefaultExtensionсредства.

Пользовательское средство должно реализовать IVsSingleFileGenerator интерфейс. Кроме того, пользовательские средства поддерживают IObjectWithSite интерфейс для получения информации из источников, отличных от входного файла. В любом случае, прежде чем использовать пользовательское средство, необходимо зарегистрировать его в системе или локальном реестре Visual Studio. Дополнительные сведения о регистрации пользовательских средств см. в разделе "Регистрация генераторов отдельных файлов".