VSProjectItem.RunCustomTool - метод
Обновлен: Ноябрь 2007
Запускает настраиваемый инструмент, связанный с объектом ProjectItem. Настраиваемый инструмент – это зарегистрированный компонент, реализующий интерфейс IVsSingleFileGenerator. Настраиваемые инструменты подобны конструкторам и редакторам.
Пространство имен: VSLangProj
Сборка: VSLangProj (в VSLangProj.dll)
Синтаксис
'Декларация
Sub RunCustomTool
'Применение
Dim instance As VSProjectItem
instance.RunCustomTool()
void RunCustomTool()
void RunCustomTool()
function RunCustomTool()
Заметки
Настраиваемый инструмент принимает в качестве входных данных файл, представленный ProjectItem, и записывает новый файл с именем, заданным в свойстве CustomToolOutput. Метод RunCustomTool управляет значением свойства CustomToolOutput следующим образом:
Если свойство CustomToolOutput оставлено пустым, в системе проекта создается соответствующее имя файла. Это имя файла основано на имени объекта ProjectItem, для которого вызван метод RunCustomTool.
Если свойство CustomToolOutput не пусто, в системе проекта используется значение этого свойства.
Если метод RunCustomTool не выполняется успешно (возвращает ошибку в HRESULT), то для свойства CustomToolOutput устанавливается в качестве значения пустая строка.
Элемент проекта, созданный с помощью RunCustomTool, заменяет любой элемент проекта, ранее созданный настраиваемым инструментом. Если настраиваемый инструмент не выполняется успешно, любой элемент проекта, ранее созданный настраиваемым инструментом, удаляется из проекта.
Перед вызовом этого метода настраиваемый инструмент должен быть связан с элементом ProjectItem путем установки свойства CustomTool объекта ProjectItem. Свойство CustomTool требует программный идентификатор для данного инструмента.
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.