IVsSingleFileGenerator IVsSingleFileGenerator IVsSingleFileGenerator IVsSingleFileGenerator IVsSingleFileGenerator IVsSingleFileGenerator Interface

Definition

Transforms a single input file into a single output file that can be compiled or added to a project. Any COM component that implements the IVsSingleFileGenerator is a custom tool.

public interface class IVsSingleFileGenerator
public interface class IVsSingleFileGenerator
__interface IVsSingleFileGenerator
[System.Runtime.InteropServices.ComConversionLoss]
[System.Runtime.InteropServices.Guid("3634494C-492F-4F91-8009-4541234E4E99")]
[System.Runtime.InteropServices.InterfaceType(1)]
public interface IVsSingleFileGenerator
type IVsSingleFileGenerator = interface
Public Interface IVsSingleFileGenerator
Derived
Attributes

Remarks

Any custom tool that is a COM component must implement the IVsSingleFileGenerator interface.

Notes to Implementers

The IVsSingleFileGenerator interface is invoked under the following circumstances:

  • The user changes the CustomTool property of a file. For more information, see Implementing Single-File Generators.


    You assign a custom tool to an input file in Visual Studio by setting the CustomTool property in the Properties window of the Visual Basic or Visual C# file selected in Solution Explorer. The component must already be registered as a custom tool before it can be assigned to an input file.

  • The user changes the CustomToolNamespace property of a file.

  • The input file to the custom tool is saved.

  • The extensibility method RunCustomTool is invoked on a VSProjectItem.

Methods

DefaultExtension(String) DefaultExtension(String) DefaultExtension(String) DefaultExtension(String) DefaultExtension(String) DefaultExtension(String)

Retrieves the file extension that is given to the output file name.

Generate(String, String, String, IntPtr[], UInt32, IVsGeneratorProgress) Generate(String, String, String, IntPtr[], UInt32, IVsGeneratorProgress) Generate(String, String, String, IntPtr[], UInt32, IVsGeneratorProgress) Generate(String, String, String, IntPtr[], UInt32, IVsGeneratorProgress) Generate(String, String, String, IntPtr[], UInt32, IVsGeneratorProgress) Generate(String, String, String, IntPtr[], UInt32, IVsGeneratorProgress)

Executes the transformation and returns the newly generated output file, whenever a custom tool is loaded, or the input file is saved.

Applies to