VCLibrarianTool.ForceSymbolReferences Property

Reference

Definition

Namespace:: Microsoft.VisualStudio.VCProjectEngine

Assembly:: Microsoft.VisualStudio.VCProjectEngine.dll

Package:: Microsoft.VisualStudio.VCProjectEngine v17.11.40252

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

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

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

[System.Runtime.InteropServices.DispId(10)]
public string ForceSymbolReferences { [System.Runtime.InteropServices.DispId(10)] get; [System.Runtime.InteropServices.DispId(10)] set; }

[<System.Runtime.InteropServices.DispId(10)>]
[<get: System.Runtime.InteropServices.DispId(10)>]
[<set: System.Runtime.InteropServices.DispId(10)>]
member this.ForceSymbolReferences : string with get, set

Public Property ForceSymbolReferences As String

Property Value

String

A reference symbol names.

Attributes: DispIdAttribute

Examples

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

[Visual Basic]

' 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

Remarks

Separate symbol names with a comma or semicolon.

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.

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

Applies to

Share via