This documentation is archived and is not being maintained.

VCLinkerTool.ForceSymbolReferences Property 

Gets or sets the linker or librarian to include a reference to this symbol.

Namespace: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (in microsoft.visualstudio.vcprojectengine.dll)

property String^ ForceSymbolReferences {
	String^ get ();
	void set ([InAttribute] String^ Symbol);
/** @property */
String get_ForceSymbolReferences ()

/** @property */
void set_ForceSymbolReferences (/** @attribute InAttribute() */ String Symbol)

function get ForceSymbolReferences () : String

function set ForceSymbolReferences (Symbol : String)

Property Value

A string representing a reference to a symbol.

ForceSymbolReferences exposes the functionality of the linker's /INCLUDE option or the librarian's /INCLUDE option.

Separate symbol names with a comma or semicolon.

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

The following example modifies the /INCLUDE librarian option in the integrated development environment (IDE):

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

Public Module Module1
    Sub Test()
        Dim mystring As String
        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("VCLibrarianTool")
        tool.ForceSymbolReferences = "symbol1,symbol2"
    End Sub
End Module