保存至图层文件 (数据管理)

摘要

从地图图层中创建输出图层文件 (.lyrx)。 图层文件存储很多输入图层的属性,例如:符号系统、标注和自定义弹出窗口。

使用情况

  • 除了地图图层之外,该工具也接受通过工具创建的图层,例如:创建要素图层创建 XY 事件图层

  • 如果输入图层包含已应用到其中的选择内容,则输出图层文件将保留此选择内容。

参数

标注说明数据类型
输入图层

要作为图层文件保存到磁盘上的地图图层。

Layer; Table View
输出图层

将创建的输出图层文件 (.lyrx)。

Layer File
存储相关路径
(可选)

指定输出图层文件是存储磁盘上源数据的相对路径还是绝对路径。

  • 取消选中 - 输出图层文件将存储磁盘上源数据的绝对路径。 这是默认设置。
  • 已选中 - 输出图层文件将存储磁盘上源数据的相对路径。 如果输出图层文件被移动,则其源路径将更新为源数据相对于新路径应处的位置。
Boolean
图层版本
(可选)

指定输出图层文件的版本。

  • 当前当前版本。 这是默认设置。
旧版本:

现在,已不再支持此参数。 保留此参数只是为了脚本和模型的向后兼容性。

在特定版本中创建的图层文件在同一系列的所有次要版本中均受支持。 例如,在 ArcGIS AllSource 3.1 中保存的图层文件可以在所有 ArcGIS AllSource 3.x 版本中使用。

要将图层及其属性保存到 ArcGIS AllSource 的不同主要版本,请使用打包图层工具。

String

arcpy.management.SaveToLayerFile(in_layer, out_layer, {is_relative_path}, {version})
名称说明数据类型
in_layer

要作为图层文件保存到磁盘上的地图图层。

Layer; Table View
out_layer

将创建的输出图层文件 (.lyrx)。

Layer File
is_relative_path
(可选)

指定输出图层文件是存储磁盘上源数据的相对路径还是绝对路径。

  • ABSOLUTE输出图层文件将存储磁盘上源数据的绝对路径。 这是默认设置。
  • RELATIVE输出图层文件将存储磁盘上源数据的相对路径。 如果输出图层文件被移动,则其源路径将更新为源数据相对于新路径应处的位置。
Boolean
version
(可选)

指定输出图层文件的版本。

旧版本:

现在,已不再支持此参数。 保留此参数只是为了脚本和模型的向后兼容性。

在特定版本中创建的图层文件在同一系列的所有次要版本中均受支持。 例如,在 ArcGIS AllSource 3.1 中保存的图层文件可以在所有 ArcGIS AllSource 3.x 版本中使用。

要将图层及其属性保存到 ArcGIS AllSource 的不同主要版本,请使用打包图层工具。

  • CURRENT当前版本。 这是默认设置。
String

代码示例

SaveToLayerFile 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 SaveToLayerFile 函数。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.SaveToLayerFile("studyquads.shp", "C:/output/studyquadsLyr.lyrx", "ABSOLUTE")
SaveToLayerFile 示例 2(独立 Python 脚本)

以下 Python 脚本演示了如何在独立脚本中使用 SaveToLayerFile 函数。

# Description: Save a layer to a file on disk

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/data"

# Set local variables
in_features = "study_quads.shp"
where_clause = '"NAME" = \'LA MESA\''
in_layer = "studyquadsLyr"
out_layer_file = "studyquadsLyr.lyrx"

# Run MakeFeatureLayer
arcpy.management.MakeFeatureLayer(in_features, "study_quads_lyr", where_clause)

# Run SaveToLayerFile
arcpy.management.SaveToLayerFile("study_quads_lyr", out_layer_file, "ABSOLUTE")