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)

Syntax

Property IgnoreDefaultLibraryNames As String

Dim instance As VCLinkerTool
Dim value As String

value = instance.IgnoreDefaultLibraryNames

instance.IgnoreDefaultLibraryNames = value
string IgnoreDefaultLibraryNames { get; set; }
property String^ IgnoreDefaultLibraryNames {
    String^ get ();
    void set (String^ value);
}
function get IgnoreDefaultLibraryNames () : String
function set IgnoreDefaultLibraryNames (value : String)

Property Value

Type: System.String

A string representing the names of the libraries to ignore.

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.

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 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

Permissions

See Also

Reference

VCLinkerTool Interface

VCLinkerTool Members

Microsoft.VisualStudio.VCProjectEngine Namespace