Compartir a través de


VSProjectItem.RunCustomTool (Método)

Actualización: noviembre 2007

Ejecuta la herramienta personalizada asociada a un objeto ProjectItem. Una herramienta personalizada es un componente registrado que implementa la interfaz IVsSingleFileGenerator. Las herramientas personalizadas son similares a los diseñadores y los editores.

Espacio de nombres:  VSLangProj
Ensamblado:  VSLangProj (en VSLangProj.dll)

Sintaxis

Sub RunCustomTool

Dim instance As VSProjectItem

instance.RunCustomTool()
void RunCustomTool()
void RunCustomTool()
function RunCustomTool()

Comentarios

Una herramienta personalizada toma como entrada el archivo representado por un objeto ProjectItem y crea un nuevo archivo cuyo nombre aparece en la propiedad CustomToolOutput. El método RunCustomTool controla el valor de la propiedad CustomToolOutput de la manera siguiente:

  • Si la propiedad CustomToolOutput está vacía, el sistema de proyectos crea un nombre de archivo adecuado; este nombre se basa en el nombre del objeto ProjectItem en el que se llamó al método RunCustomTool.

  • Si la propiedad CustomToolOutput no está vacía, el sistema de proyectos utiliza el valor existente.

  • Si el método RunCustomTool no se ejecuta correctamente (devuelve un error en HRESULT), la propiedad CustomToolOutput se establece en una cadena vacía.

  • El elemento de proyecto creado por el método RunCustomTool reemplaza a cualquier elemento de proyecto creado con anterioridad mediante la herramienta personalizada. Si ésta no se ejecuta correctamente, cualquier elemento de proyecto creado anteriormente por la herramienta se quita del proyecto.

Para poder llamar a este método, se debe asociar una herramienta personalizada al objeto ProjectItem estableciendo la propiedad CustomTool del objeto ProjectItem. La propiedad CustomTool requiere el identificador de programa de la herramienta.

Permisos

Vea también

Referencia

VSProjectItem (Interfaz)

VSProjectItem (Miembros)

VSLangProj (Espacio de nombres)