esri_webfeaturelayer_add (AutoLISP)

使用可选过滤查询添加新 Web 要素图层。 将绘制工程区域内生成的要素。 如果要添加的 web 图层是安全的，则将提示用户输入门户所需的凭据。

语法

(esri_webfeaturelayer_add url [service_properties])

参数

• url | 字符串 | 必填 | 要添加到工程图的有效 web 要素图层的 URL。
• service_properties | 关联列表 | 可选 | 点对形式的 web 要素图层属性的关联列表，如下表定义：

相关标注	值类型	值描述	必填或可选
"DEFINITIONEXPRESSION"	字符串	WHERE 子句表达式，用于按属性值限制图层中的要素。 WHERE 子句的语法取决于源数据。	可选
"BRANCHNAME"	字符串	Web 要素图层上可用的分支版本的名称。	可选

示例用法 1

尝试在 FID 字段值大于 3800 的位置添加 USA Major Cities web 要素图层：

(esri_webfeaturelayer_add "https://www.arcgis.com/home/item.html?id=85d0ca4ea1ca4b9abf0c51b9bd34de2e"
(list (cons "DEFINITIONEXPRESSION" "FID > 3800")))

结果示例用法 1

在 FID 字段值大于 3800 的当前工程区域内添加 USA Major Cities web 要素图层并绘制要素，该函数将返回一个 true 列表：

(T)

示例用法 2

尝试在 STATE_NAME 字段值以字母 N 开头的位置添加 USA States Generalized Boundaries web 要素图层和要素：

(esri_webfeaturelayer_add "https://esri.maps.arcgis.com/home/item.html?id=8c2d6d7df8fa4142b0a1211c8dd66903"
(list (cons "DEFINITIONEXPRESSION" "STATE_NAME LIKE \'N%\'")))

结果示例用法 2

在 STATE_NAME 字段值以字母 N 开头的当前工程区域内添加 USA States Generalized Boundaries web 要素图层并绘制要素，该函数将返回一个 true 列表：

(T)

示例用法 3

尝试在不进行任何过滤查询的情况下添加所有 PoolPermits web 要素图层：

(esri_webfeaturelayer_add "http://sampleserver6.arcgisonline.com/arcgis/rest/services/PoolPermits/FeatureServer")

结果示例用法 3

添加 PoolPermits web 要素图层并在工程区域内绘制所有要素，该函数将返回一个 true 列表：

(T)

示例用法 4

尝试在 FID 字段值大于 3800 的位置添加 DamageAssessment web 要素图层的 editor01.triangle 分支：

(esri_webfeaturelayer_add "https://sampleserver7.arcgisonline.com/server/rest/services/DamageAssessment/FeatureServer"
    (list 
        (cons "DEFINITIONEXPRESSION" "FID > 3800")
        (cons "BRANCHNAME" "editor01.triangle") 
    )
)

结果示例用法 4

在 FID 字段值大于 3800 的位置添加 DamageAssessment web 要素图层的 editor01.triangle 分支，该函数将返回一个 true 列表：

(T)

返回值

以下是可能的返回值：

• 如果成功，则该函数将返回一个 true 列表：(T)

  注：

  软件异步行为

  如果可以解释提供的 URL，即使未完全添加该服务，该函数也将返回 (T)。 在要素完成绘制之前，该函数将返回 (T)。 返回值 (nil) 通常表示服务未连接。

• 如果失败，则该函数将返回一个列表，其中第一个值为 nil，然后是一个包含键值 "Error" 的关联列表以及字符串形式的关联错误消息：(nil ("Error" . "<message>"))，或者仅返回 (nil)。

失败的返回值

出于以下任一原因，可能出现失败的返回值：

• (nil ("Error" . "Invalid URL"))

  提供的 URL 无效。

• (nil ("Error" . "Error"))

  提供的 URL 无效。

• (nil ("Error" . "Missing required argument."))

  未提供一个或多个必填参数。

另请参阅

(esri_docfeaturelayer_add) | 添加新的文档要素图层。

(esri_weblayer_add) | 添加新的 Web 图层：影像图层、地图影像图层或 Web 要素图层。