esri_fielddef_add (AutoLISP)

将新字段定义添加到现有文档要素图层中。

注：

无法修改 web 要素图层的字段定义。

语法

(esri_fielddef_add flname field_properties)

参数

• flname | 字符串 | 必填 | 工程图中的现有文档要素图层名称。
• field_properties | 关联列表 | 必填 | 点对形式的参数列表，如下表定义：

相关标注	值类型	值描述	必填或可选
"NAME"	字符串	字段名。	必填
"TYPE"	字符串	字段类型值。{"Double", "Short", "GUID", "Integer", "String", "Float", "Date"}	可选（默认 "String"）
"LENGTH"	整型	字段长度。	可选
"VALUE"	变量	默认字段值。 注： 在使用具有编码属性域值的字段时，这是描述，而非代码。	可选

示例用法

尝试将名为 YearPurchased 的短整型字段添加到 Parks 要素图层。

(esri_fielddef_add "Parks"
  (list
    (cons "name" "YearPurchased")
    (cons "Type" "Short")
    (cons "value" "1954")
  )
)

结果示例用法

将名为 YearPurchased 的短整型字段添加到 Parks 要素图层，并返回包含该字段名称的列表。

("YearPurchased")

返回值

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

失败的返回值

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

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

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

• (nil ("Error" . "Field name already exists."))

  所使用的字段名称已存在。

• (nil ("Error" . "Feature layer not found."))

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

• (nil ("Error" . " Schema doesn't support editing."))

  无法修改 web 要素图层的字段定义。