VCConfiguration.WholeProgramOptimization Property

Reference

Definition

Namespace:: Microsoft.VisualStudio.VCProjectEngine

Assembly:: Microsoft.VisualStudio.VCProjectEngine.dll

Package:: Microsoft.VisualStudio.VCProjectEngine v17.11.40252

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets cross-module optimizations by delaying code generation to link time. WholeProgramOptimization exposes the functionality of the compiler's /GL (Whole Program Optimization) option.

public:
 property Microsoft::VisualStudio::VCProjectEngine::WholeProgramOptimizationTypes WholeProgramOptimization { Microsoft::VisualStudio::VCProjectEngine::WholeProgramOptimizationTypes get(); void set(Microsoft::VisualStudio::VCProjectEngine::WholeProgramOptimizationTypes value); };

public:
 property Microsoft::VisualStudio::VCProjectEngine::WholeProgramOptimizationTypes WholeProgramOptimization { Microsoft::VisualStudio::VCProjectEngine::WholeProgramOptimizationTypes get(); void set(Microsoft::VisualStudio::VCProjectEngine::WholeProgramOptimizationTypes value); };

[System.Runtime.InteropServices.DispId(741)]
public Microsoft.VisualStudio.VCProjectEngine.WholeProgramOptimizationTypes WholeProgramOptimization { [System.Runtime.InteropServices.DispId(741)] get; [System.Runtime.InteropServices.DispId(741)] set; }

[<System.Runtime.InteropServices.DispId(741)>]
[<get: System.Runtime.InteropServices.DispId(741)>]
[<set: System.Runtime.InteropServices.DispId(741)>]
member this.WholeProgramOptimization : Microsoft.VisualStudio.VCProjectEngine.WholeProgramOptimizationTypes with get, set

Public Property WholeProgramOptimization As WholeProgramOptimizationTypes

Property Value

WholeProgramOptimizationTypes

A WholeProgramOptimizationTypes enumeration.

Attributes: DispIdAttribute

Examples

See How to: Compile Example Code for Project Model Extensibility for information about how to compile and run this example.

The following example modifies the VCConfiguration object's WholeProgramOptimization property in the integrated development environment (IDE):

' add reference to Microsoft.VisualStudio.VCProjectEngine.  
Imports EnvDTE  
Imports Microsoft.VisualStudio.VCProjectEngine  

Public Module Module1  
    Sub Test()  
        Dim Test As Boolean  
        Dim prj As VCProject  
        Dim cfgs As IVCCollection  
        Dim cfg As VCConfiguration  
        Dim MyDbg As VCDebugSettings  
        prj = DTE.Solution.Projects.Item(1).Object  
        cfgs = prj.Configurations  
        cfg = cfgs.Item(1)  
        cfg.WholeProgramOptimization = True  
    End Sub  
End Module

Remarks

It is better to set the VCConfiguration object's WholeProgramOptimization property rather than to set the compiler property of the same name and the linker's LinkTimeCodeGeneration property.

The compiler's version of this property and the linker's LinkTimeCodeGeneration property are not available via the property pages.

Applies to

Share via