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
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.