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)
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
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.