VCFileConfiguration.Compile Method
Compiles the selected file or reference.
Namespace: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)
Syntax
'Declaration
Sub Compile ( _
forceBuild As Boolean, _
waitOnBuild As Boolean _
)
void Compile(
bool forceBuild,
bool waitOnBuild
)
void Compile(
[InAttribute] bool forceBuild,
[InAttribute] bool waitOnBuild
)
abstract Compile :
forceBuild:bool *
waitOnBuild:bool -> unit
function Compile(
forceBuild : boolean,
waitOnBuild : boolean
)
Parameters
- forceBuild
Type: System.Boolean
A Boolean value that determines whether to force build. true if yes, false if no.
- waitOnBuild
Type: System.Boolean
A Boolean value that determines whether to wait on build. true if yes, false if no.
Remarks
If forceBuild is set to true, compilation does not occur unless the project is out of date. When you initiate a compilation in the user interface (UI) by right-clicking a project, it is the same as if forceBuildis true and waitOnBuildis false. If you depend on the build for output, you should set waitOnBuild to true.
Examples
' Compiles the first project in the solution.
' Add a reference to Microsoft.VisualStudio.VCProjectEngine and have
' a Visual C++ project loaded before running this example.
Imports EnvDTE
Imports Microsoft.VisualStudio.VCProjectEngine
Public Module Module1
Sub Test()
Dim file As VCFile
Dim col As IVCCollection
Dim fileconfig As VCFileConfiguration
Dim prj As VCProject
prj = DTE.Solution.Projects.Item(1).Object
col = prj.Files
file = col.Item(1)
col = file.FileConfigurations
fileconfig = col.Item("Debug|Win32")
fileconfig.Compile(False, True)
End Sub
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.