This documentation is archived and is not being maintained.

ForceSymbolReferences Property

Visual Studio .NET 2003

Forces the linker or librarian to include a reference to this symbol. Exposes the functionality of the linker's /INCLUDE option or the librarian's /INCLUDE option.

[Visual Basic .NET]
Public Property ForceSymbolReferences() As String
[Visual Basic 6]
Property Get ForceSymbolReferences() As String
Property Let ForceSymbolReferences( _
   ByVal NewValue As String _
HRESULT __stdcall get_ForceSymbolReferences(
   /* [out, retval] */ BSTR* retVal
HRESULT __stdcall put_ForceSymbolReferences(
   /* [in] */ BSTR NewValue
public string ForceSymbolReferences {get; set;}
[JScript .NET]
public function get ForceSymbolReferences() : String
public function set ForceSymbolReferences(
   NewValue : String


Separate symbol names with a comma or semicolon.


The following sample code modifies the /INCLUDE librarian option in the development environment:

' 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

See Samples for Project Model Extensibility for information on how to compile and run this sample.

See Also

Applies To: VCLibrarianTool Object | VCLinkerTool Object