VCLinkerTool.MapFileName Property

Gets or sets the name for the mapfile.

Namespace:  Microsoft.VisualStudio.VCProjectEngine
Assembly:  Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)

Syntax

Property MapFileName As String

Dim instance As VCLinkerTool
Dim value As String

value = instance.MapFileName

instance.MapFileName = value

string MapFileName { get; set; }

property String^ MapFileName {
    String^ get ();
    void set (String^ value);
}

function get MapFileName () : String
function set MapFileName (value : String)

Property Value

Type: System.String

A string representing the name of the mapfile.

Remarks

MapFileName exposes the functionality of the /MAP (Generate Mapfile) linker option.

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 MapFileName 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
        prj = DTE.Solution.Projects.Item(1).Object
        cfgs = prj.Configurations
        cfg = cfgs.Item(1)
        tool = cfg.Tools("VCLinkerTool")
        tool.GenerateMapFile = True
        tool.MapFileName = "my.map"
    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.

See Also

Concepts

/MAP (Generate Mapfile)

/MAPINFO (Include Information in Mapfile)

Reference

VCLinkerTool Interface

VCLinkerTool Members

Microsoft.VisualStudio.VCProjectEngine Namespace