VSProjectItem.RunCustomTool (Método)
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
'Declaración
Sub RunCustomTool
void RunCustomTool()
void RunCustomTool()
abstract RunCustomTool : unit -> unit
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 esta 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.
Seguridad de .NET Framework
- 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.