VCLinkerTool.OptimizeReferences Property

Enables elimination of functions or data that are never referenced.

Namespace:  Microsoft.VisualStudio.VCProjectEngine
Assembly:  Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)

Syntax

'Declaration
Property OptimizeReferences As optRefType
    Get
    Set
optRefType OptimizeReferences { get; set; }
property optRefType OptimizeReferences {
    optRefType get ();
    void set (optRefType value);
}
abstract OptimizeReferences : optRefType with get, set
function get OptimizeReferences () : optRefType
function set OptimizeReferences (value : optRefType)

Property Value

Type: Microsoft.VisualStudio.VCProjectEngine.optRefType
An optRefType enumeration.

Remarks

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

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

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

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

.NET Framework Security

See Also

Reference

VCLinkerTool Interface

Microsoft.VisualStudio.VCProjectEngine Namespace