ArcGISProject

摘要

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

说明

使用 ArcGISProject 函数创建 ArcGISProject 对象有两种不同的方法。 第一种，也是首推方法，即提供磁盘上工程文件 (.aprx) 位置的系统路径。 该方法最为常用，因为随后可在 ArcGIS Pro 应用程序外部运行脚本。 引用磁盘上的特定工程这种方法可对脚本执行方式予以更多控制，因为给定脚本可能无法与所有工程一起使用。 这些工程在内存中打开，仅在您导出结果或保存工程、打开工程并验证更改后，执行的更改才可见。

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

注：

如果您在应用程序中运行脚本，并使用路径而非 CURRENT 关键字引用工程，则更改不会发生在当前应用程序中。 如果您希望立即在脚本中看到更改，则必须在应用程序中并且使用 CURRENT 关键字。

注：

工程可以被多次引用，但是仅第一次引用可以使用 ArcGISProject 类的 save 方法直接保存。 其他工程引用将以只读状态打开。 ArcGISProject 类具有一个 isReadOnly 属性，可用于确定工程的读/写状态。

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

语法

ArcGISProject (aprx_path)

参数	说明	数据类型
aprx_path	The full system path and file name of an existing ArcGIS project (.aprx) or the CURRENT keyword.	String

返回值

数据类型	说明
ArcGISProject	ArcGISProject 对象用于访问工程属性和方法。 大多数 arcpy.mp 脚本操作都需要引用此对象。

代码示例

ArcGISProject 示例 1

下面的代码行引用了磁盘上的工程并可从 ArcGIS Pro 会话外部（如从 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")