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

摘要

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

使用情况

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

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

  • 无法在 ArcMap 中使用从 AllSource 中保存的图层文件。

参数

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

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

Layer
输出图层

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

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

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

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

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

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

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

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

Layer
out_layer

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

Layer File
is_relative_path
(可选)

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

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

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

  • 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: Saves 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")