This documentation is archived and is not being maintained.

VCLinkerTool.IgnoreDefaultLibraryNames Property 

Gets or sets one or more default libraries to ignore.

Namespace: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (in microsoft.visualstudio.vcprojectengine.dll)

Property IgnoreDefaultLibraryNames As String
Dim instance As VCLinkerTool
Dim value As String

value = instance.IgnoreDefaultLibraryNames

instance.IgnoreDefaultLibraryNames = value
/** @property */
String get_IgnoreDefaultLibraryNames ()

/** @property */
void set_IgnoreDefaultLibraryNames (/** @attribute InAttribute() */ String Lib)

function get IgnoreDefaultLibraryNames () : String

function set IgnoreDefaultLibraryNames (Lib : String)

Property Value

A string representing the names of the libraries to ignore.

IgnoreDefaultLibraryNames exposes the functionality of the /NODEFAULTLIB linker option and the /NODEFAULTLIB LIB option.

Separate multiple library names with a semicolon.

See Samples for Project Model Extensibility for information about how to compile and run this example.

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
    End Sub
End Module