VCLinkerTool.IgnoreDefaultLibraryNames 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 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

String

A string representing the names of the libraries to ignore.

Attributes: DispIdAttribute

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

Share via