esri_webfeaturelayer_addAttachment (AutoLISP)

该函数将文件附加到支持附件且用户角色支持编辑或更高级别功能的 web 要素图层的要素。 在添加附件之前，必须同步新要素。

语法

(esri_webfeaturelayer_addAttachment flname ename filepath)

参数

• flname | 字符串 | 必填 | 工程图中现有的 web 要素图层名称
• ename | 实体名称 | 必填 | 要添加附件的要素的 AutoCAD 实体名称
• filepath | 字符串 | 必填 | 要附加的文件的目标文件路径

示例用法 1

提示用户从名为 "Damage_to_Residential_Buildings" 的 web 要素图层中选择一个实体，并尝试添加名为 "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" 的附件文件

(progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment 
  "Damage_to_Residential_Buildings" 
  ename 
  "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))

结果示例用法 1

随即将 "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" 文件添加到服务器上的所选要素，并且该函数将返回：

(T)

示例用法 2

提示用户从名为 "Shelters" 的 web 要素图层中选择一个实体，并尝试添加名为 "C:\\CADwork\\Attachments\\LandSurface.xml" 的附件文件。 但是，该 web 要素图层不支持附件。

(progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment 
  "shelters" 
  ename
  "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))

结果示例用法 2

未添加 LandSurface.xml 文件，并且该函数将返回：

 (nil ("Error" . "Layer does not support attachments"))

返回值

该函数将返回一个值。

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

失败的返回值

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

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

  未提供三个必填参数之一。

• (nil ("Error" . "Web feature layer not found."))

  指定的 web 要素图层值不是工程图中的有效 web 要素图层。

• (nil ("Error" . "No connected web feature layers found."))

  与 web 要素图层的网络连接丢失。

• (nil ("Error" . "Layer does not support attachments"))

  指定的 web 要素图层不支持附件。

• (nil ("Error" . "File not found."))

  指定文件不存在

• (nil ("Error" . "No feature found."))

  指定的实体不是指定 web 要素图层的有效要素。