Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

VCLinkerTool.IgnoreDefaultLibraryNames Property

Definition

Namespace:
Microsoft.VisualStudio.VCProjectEngine
Assembly:
Microsoft.VisualStudio.VCProjectEngine.dll
Package:
Microsoft.VisualStudio.VCProjectEngine v17.14.40264

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 one or more default libraries to ignore.

public:
 property System::String ^ IgnoreDefaultLibraryNames { System::String ^ get(); void set(System::String ^ value); };
public:
 property Platform::String ^ IgnoreDefaultLibraryNames { Platform::String ^ get(); void set(Platform::String ^ value); };
[System.Runtime.InteropServices.DispId(22)]
public string IgnoreDefaultLibraryNames { [System.Runtime.InteropServices.DispId(22)] get; [System.Runtime.InteropServices.DispId(22)] set; }
[<System.Runtime.InteropServices.DispId(22)>]
[<get: System.Runtime.InteropServices.DispId(22)>]
[<set: System.Runtime.InteropServices.DispId(22)>]
member this.IgnoreDefaultLibraryNames : string with get, set
Public Property IgnoreDefaultLibraryNames As String

Property Value

A string representing the names of the libraries to ignore.

Attributes

Examples

The following example modifies the IgnoreDefaultLibraryNames linker property in the integrated development environment (IDE):

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

Public Module Module1 
 Sub Test() 
 Dim prj As VCProject 
 Dim cfgs, tools As IVCCollection 
 Dim cfg As VCConfiguration 
 Dim tool As VCLinkerTool 
 Dim oldNames As String 
 prj = DTE.Solution.Projects.Item(1).Object 
 cfgs = prj.Configurations 
 cfg = cfgs.Item(1) 
 tool = cfg.Tools("VCLinkerTool") 
 tool.IgnoreDefaultLibraryNames = "" 
 oldNames = tool.IgnoreDefaultLibraryNames 
 tool.IgnoreDefaultLibraryNames = "some.dll;" + oldNames 
 MsgBox(tool.IgnoreDefaultLibraryNames) 
 End Sub 
End Module

Remarks

IgnoreDefaultLibraryNames exposes the functionality of the /NODEFAULTLIB (Ignore Libraries) linker option and the Managing a Library LIB option.

Separate multiple library names with a semicolon.

Applies to