Partager via

VCLinkerTool.ForceSymbolReferences Property

  • Article

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)

Syntax

Property ForceSymbolReferences As String

Dim instance As VCLinkerTool
Dim value As String

value = instance.ForceSymbolReferences

instance.ForceSymbolReferences = value

string ForceSymbolReferences { get; set; }

property String^ ForceSymbolReferences {
    String^ get ();
    void set (String^ value);
}

function get ForceSymbolReferences () : String
function set ForceSymbolReferences (value : String)

Property Value

Type: System.String

A string representing a reference to a symbol.

Remarks

ForceSymbolReferences exposes the functionality of the linker's /INCLUDE (Force Symbol References) option or the librarian's Building an Import Library and Export File option.

Separate symbol names with a comma or semicolon.

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 /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

Permissions

See Also

Reference

VCLinkerTool Interface

VCLinkerTool Members

Microsoft.VisualStudio.VCProjectEngine Namespace