-pathmap

指定如何将物理路径映射到编译器输出的源路径名称。

Syntax

-pathmap:path1=sourcePath1,path2=sourcePath2

Arguments

术语 Definition
path1 必填。 当前环境中源文件的完整路径。
sourcePath1 必填。 任何输出文件中替换为 path1 的源路径。

注解

注释

指定 -pathmap 可防止断点在本地调试版本中工作。 仅针对生产或持续集成生成进行设置 -pathmap

编译器 -pathmap 选项指定如何将物理路径映射到编译器输出的源路径名称。 此选项将编译器在其上运行的计算机上的每个物理路径映射到应写入输出文件的相应路径。

要指定多个映射的源路径,请用逗号分隔每个路径。

编译器将源路径写入其输出,原因如下:

  • CallerFilePathAttribute 应用于可选参数时,会将源路径替换为参数。
  • PDB 文件中嵌入的源路径。
  • PDB 文件的路径嵌入到 PE(可移植的可执行文件)文件中。

此选项 -pathmap 在 Visual Studio 开发环境中不可用;仅在从命令行编译时才可用。

Example

以下示例编译 Test.vb 并映射源路径:

vbc -pathmap:C:\MyProject\=\BuildServer\,C:\Temp\=\BuildTemp\ Test.vb

在此示例中,如果源文件位于 C:\MyProject\Program.vb,它将在输出中显示为 \BuildServer\Program.vb

另请参阅