VCLinkerTool.OptimizeReferences Property

Definition

Namespace:: Microsoft.VisualStudio.VCProjectEngine

Assembly:: Microsoft.VisualStudio.VCProjectEngine.dll

Package:: Microsoft.VisualStudio.VCProjectEngine v17.14.40264

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.

Enables elimination of functions or data that are never referenced.

public:
 property Microsoft::VisualStudio::VCProjectEngine::optRefType OptimizeReferences { Microsoft::VisualStudio::VCProjectEngine::optRefType get(); void set(Microsoft::VisualStudio::VCProjectEngine::optRefType value); };

public:
 property Microsoft::VisualStudio::VCProjectEngine::optRefType OptimizeReferences { Microsoft::VisualStudio::VCProjectEngine::optRefType get(); void set(Microsoft::VisualStudio::VCProjectEngine::optRefType value); };

[System.Runtime.InteropServices.DispId(80)]
public Microsoft.VisualStudio.VCProjectEngine.optRefType OptimizeReferences { [System.Runtime.InteropServices.DispId(80)] get; [System.Runtime.InteropServices.DispId(80)] set; }

[<System.Runtime.InteropServices.DispId(80)>]
[<get: System.Runtime.InteropServices.DispId(80)>]
[<set: System.Runtime.InteropServices.DispId(80)>]
member this.OptimizeReferences : Microsoft.VisualStudio.VCProjectEngine.optRefType with get, set

Public Property OptimizeReferences As optRefType

Property Value

optRefType

An optRefType enumeration.

Attributes: DispIdAttribute

Examples

The following example modifies the OptimizeReferences 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 prj As VCProject  
    Dim cfgs, tools As IVCCollection  
    Dim cfg As VCConfiguration  
    Dim tool As VCLinkerTool  
    prj = DTE.Solution.Projects.Item(1).Object  
    cfgs = prj.Configurations  
    cfg = cfgs.Item(1)  
    tool = cfg.Tools("VCLinkerTool")  
    tool.OptimizeReferences = optRefType.optReferences  
  End Sub  
End Module

Remarks

OptimizeReferences exposes the functionality of the /OPT (Optimizations) linker option.

Use the optRefType enumeration to change the value of this property.

Applies to