ArcGISProject

摘要

提供对磁盘上存储的 ArcGIS 工程 (.aprx) 的引用或对当前使用 CURRENT 关键字在 ArcGIS Pro 应用程序内进行加载的工程的引用。

说明

使用 ArcGISProject 函数创建 ArcGISProject 对象有两种不同的方法。第一种,也是首推方法,即提供磁盘上工程文件 (.aprx) 位置的系统路径。该方法最为常用,因为随后可在 ArcGIS Pro 应用程序外部运行脚本。引用磁盘上的特定工程这种方法可对脚本执行方式予以更多控制,因为给定脚本可能无法与所有工程一起使用。

第二种方法是将 CURRENT 关键字作为 ArcGISProject 函数的输入参数。该方法仅适用于 ArcGIS Pro 应用程序内部,因为 ArcGISProject 对象引用当前加载到 ArcGIS Pro 应用程序中的工程。CURRENT 关键字可用于 Python 窗口或与地理处理脚本工具一起使用。

有关更详细的说明和代码示例,请参阅 ArcGISProject 类帮助。

语法

ArcGISProject (aprx_path)
参数说明数据类型
aprx_path

包含现有 ArcGIS 工程 (.aprx) 的完整系统路径和文件名的字符串或包含 CURRENT 关键字的字符串。

String
返回值
数据类型说明
ArcGISProject

ArcGISProject 对象用于访问工程属性和方法。大多数地图脚本操作都需要引用此对象。

代码示例

ArcGISProject 示例 1

下面的代码行引用了磁盘上的工程并可从 ArcGIS 会话外部(如从 Python IDE)运行。

import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\YosemiteNP\Yosemite.aprx")
ArcGISProject 示例 2

下面的代码行需要从 ArcGIS Pro 应用程序内部运行,这是因为该代码行使用的关键字是 CURRENT。该示例将在 Python 窗口内工作或从地理处理脚本工具运行。

aprx = arcpy.mp.ArcGISProject("CURRENT")