This documentation is archived and is not being maintained.

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)

optRefType OptimizeReferences { get; set; }
/** @property */
optRefType get_OptimizeReferences ()

/** @property */
void set_OptimizeReferences (/** @attribute InAttribute() */ optRefType optSetting)

function get OptimizeReferences () : optRefType

function set OptimizeReferences (optSetting : optRefType)

Property Value

An optRefType enumeration.

OptimizeReferences exposes the functionality of the /OPT linker option.

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

See Samples for Project Model Extensibility for information about how to compile and run this example.

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